Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 1 addition & 2 deletions docs/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,9 @@

## [0.3.12](https://github.com/sprintertech/sprinter-sdk/compare/docs-v0.3.11...docs-v0.3.12) (2025-10-31)


### Bug Fixes

* Update to solve api for gas limits ([#193](https://github.com/sprintertech/sprinter-sdk/issues/193)) ([f8e77a6](https://github.com/sprintertech/sprinter-sdk/commit/f8e77a667db859a184812db4d69d6a38c20776fc))
- Update to solve api for gas limits ([#193](https://github.com/sprintertech/sprinter-sdk/issues/193)) ([f8e77a6](https://github.com/sprintertech/sprinter-sdk/commit/f8e77a667db859a184812db4d69d6a38c20776fc))

## [0.3.11](https://github.com/sprintertech/sprinter-sdk/compare/docs-v0.3.10...docs-v0.3.11) (2025-10-09)

Expand Down
74 changes: 74 additions & 0 deletions docs/_temp/05-points.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
---
id: Stash-points
title: Stash points
sidebar_position: 5
---

# Stash points

Your participation now earns Stash points, a new rewards system that tracks your contributions across the Sprinter ecosystem.

# Current Activities

## Track Event 1

- The first event will be The 100M Stash, where you can earn Stash points by depositing USDC into Sprinter Stash and locking your liquidity for a chosen duration.

- Stash LPs receive a 1 points per $1 of USDC staked in the liquidity pools

- More ways to earn will be revealed in the coming weeks, in addition to the leaderboard going live soon - so keep stacking points and we’ll see who’s leading the race.

### Early LPs get a head start

Sprinter Stash rewards liquidity providers with points, and yield that scales based on how long you lock your funds. The longer you commit, the higher your multiplier, starting at 0.4x for a 3-month lock, up to a generous 2.2x for a 12-month commitment.

And for early adopters, there’s an additional reason to act fast: deposits made within the first 48 hours of each milestone unlock a **100% SPRNT bonus** on your USDC deposit, on top of your regular rewards. No extra steps required — just show up early, and your bonus will be automatically applied.

To kick things off, we’re rewarding our earliest Stashers with both **base multipliers** and **bonus points**.

**Base Multipliers**

Lock your liquidity and earn more Stash points based on your commitment:

- **3-Month Lock** → 0.4x Stash points
- **6-Month Lock** → 1.0x Stash points
- **12-Month Lock** → 2.2x Stash points

**Bonus rewards (First 48 Hours)**

Deposit USDC in the first **48 hours** of each milestone and you’ll receive a **100% bonus** on your USDC deposit, in Stash points — no extra steps needed.

### How to Stash

Sprinter Stash gives LPs access to dynamic, multichain rewards - powered by solver activity and protocol incentives.

Here’s how it flows:

1. Visit https://app.sprinter.tech/
2. **Connect your wallet & select a chain**

Deposit USDC directly into Sprinter Stash.

3. **Choose your Stash lockup**

You can lock your Stash for 3 months, 6 or 12. (Or you can chose not to lock and just earn the APY).

4. **Stash allocates liquidity across chains**

Liquidity is algorithmically rebalanced to meet solver demand in real time.

5. **Solvers use credit instantly**

Solvers borrow on destination chains without collateral to execute trades and arbitrage opportunities cross-chain.

6. **Settlement & rewards**

Once filled, funds are repaid on the source chain. Profits flow back to LPs as APY, solver and strategy fees.

You earn from:

- **Solver fees**
- **Strategy fees**
- **Multi-dimentional Passive yield**
- **Stash points**
- **Rewards** (post TGE)
11 changes: 7 additions & 4 deletions docs/docs/01-introduction/01-introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ sidebar_position: 1
---

<div class="logo-container">
<img src="/img/sprinter-header.png" class="logo-light-mode" alt="Sprinter Logo Black" />
<img src="/img/sprinter-header.png" class="logo-dark-mode" alt="Sprinter Logo White" />
<img src="/img/credit header.png" class="logo-light-mode" alt="Sprinter Logo Black" />
<img src="/img/credit header.png" class="logo-dark-mode" alt="Sprinter Logo White" />
</div>

#
Expand All @@ -16,13 +16,15 @@ Sprinter envisions a decentralized, open and equitable financial system that pro

# What is Sprinter?

Sprinter combines solving-as-a-service infrastructure with credit-based crosschain liquidity. It enables solvers to borrow and execute onchain actions without pre-funded inventory, while giving dApps and protocols access to best-in-class execution routes, powered by the Project Blanc advanced solving technology.
Sprinter combines solving-as-a-service infrastructure with credit-based crosschain liquidity. It enables venues to borrow and execute onchain actions without pre-funded inventory, while giving dApps and protocols access to best-in-class execution routes, powered by the Project Blanc advanced solving technology.

## Sprinter’s Core Products

### [Sprinter Stash](Stash)

A crosschain credit protocol providing liquidity access to solvers and market makers without requiring collateral. Liquidity providers deposit USDC into the protocol, earning returns through solver fees and passive yield strategies.
Sprinter Stash is a universal credit protocol that powers the next-generation of use cases, from solver credit lines to trading, whilst rewarding LPs with sustainable, risk-managed stablecoin yield.

Stash provides zero-collateral credit, so solvers don’t need capital, users don’t need to touch bridges, and dApps get instant fills.

### [Sprinter Solve](Solve)

Expand All @@ -37,3 +39,4 @@ If you have questions about Sprinter, the code, the docs, or have a partnership
- **Telegram:** [t.me/sprinter_tech](https://t.me/sprinter_tech)
- **X:** [@sprinter_ux](https://x.com/sprinter_ux)
- **Website:** [sprinter.tech](https://sprinter.tech)
- **Blog:** [blog.sprinter.tech](https://blog.sprinter.tech)
163 changes: 66 additions & 97 deletions docs/docs/02-Stash/01-utilizing-stash.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,18 @@
---
id: use-stash
title: Stash API quick start
title: Stash API Integration Guide
sidebar_position: 1
---

:::tip
Request your Stash API key via [Sprinter Stash Request](https://forms.gle/kgpcQK722Ley2gke7) or contacting support@sprinter.tech
:::

## As a Solver
## For crosschain DeFi

Sprinter Stash enables solvers to **borrow crosschain credit on-demand** to execute user intents without needing pre-funded inventory.

This guide covers:

1. Recap of the [Stash Fill Lifecycle](use-stash#1-stash-solver-fill-lifecycle)
2. Requesting a [Credit Borrow Quote Estimate](use-stash#2-request-a-credit-borrow-quote-estimate-optional)
3. Requesting a [Final Borrow Cost and Credit Authorization](use-stash#3-request-the-final-credit-borrow-cost)
4. Check out the [Fill Optimization Tips](use-stash#4-fill-optimization-tips)

### 1. Stash Fill Lifecycle
## Overview of the Stash Fill Lifecycle

<div style={{ display: "flex", justifyContent: "center" }}>

Expand All @@ -35,107 +28,83 @@ flowchart TD
H --> I[Intent Protocol Repays Borrowed Credit + Costs]
I --> J[Fill Complete]

click B "use-stash#2-request-a-borrow-cost-estimate-optional" "Borrow Cost"
click B "borrow-quote-api" "Borrow Cost"
style B fill:#FF9B43,stroke:#333,stroke-width:2px,color:#000,font-weight:bold

click E "use-stash#3-request-a-final-borrow-quote" "Borrow Quote"
click E "borrow-cost-api" "Borrow Quote"
style E fill:#FF9B43,stroke:#333,stroke-width:2px,color:#000,font-weight:bold

```

</div>

### 2. Request a Credit Borrow Quote Estimate (Optional)

Call the [**Borrow Quote API**](borrow-quote-api) to preview an estimated borrowing cost for a potential fill before requesting credit. This can be based on input or output amount.

```ts title="Request Borrow Quote Estimate with type ExactInput (input amount - borrow costs)"
const baseUrl = "https://api.sprinter.tech";
const sourceChainId = "eip155:8453"; // eip155:8453(Base), eip155:10 (Optimism), eip155:42161 (Arbitrum). ChainId must use capid format from our configuration
const protocol = "across"; // "across" or "mayan"
const type = "ExactInput"; // Request will consider the amount as (input amount - borrow costs)
const amount = 10000000; // This is the ExactInput eg 1 USDC (6 decimals)
const response = await fetch(
`${baseUrl}/liquidity/chain/${sourceChainId}/protocol/${protocol}/type/${type}/quote`,
{
method: "GET",
headers: {
"X-Auth-Token": "<your_api_key>",
},
body: {
amount: amount,
token: "destination_token_address", // Token address
network: "eip155:10", // Destination_Chain_ID
},
},
);

const borrowQuote = await response.json();
console.log("Expected amount:", borrowQuote.expectedOutput);
console.log("Borrow Cost:", borrowQuote.borrowCost);
```
## How Stash Enables Zero-Collateral Loans

```ts title="Request Final Borrow Quote Estimate with type ExactOutput (output amount + borrow costs)"
const baseUrl = "https://api.sprinter.tech";
const sourceChainId = "eip155:8453"; // eip155:8453(Base), eip155:10 (Optimism), eip155:42161 (Arbitrum). ChainId must use capid format from our configuration
const protocol = "across"; // "across" or "mayan"
const type = "ExactOutput"; // Request will consider the amount as (output amount + borrow costs)
const amount = 10000000; // This is the ExactInput eg 1 USDC (6 decimals)
const response = await fetch(
`${baseUrl}/liquidity/chain/${sourceChainId}/protocol/${protocol}/type/${type}/quote`,
{
method: "GET",
headers: {
"X-Auth-Token": "<your_api_key>",
},
body: {
amount: amount,
token: "destination_token_address", // Token address
network: "eip155:10", // Destination_Chiain_ID
},
},
);

const borrowQuote = await response.json();

console.log("Expected Input:", borrowQuote.requiredInput);
console.log("Borrow Cost:", borrowQuote.borrowCost);
```
Sprinter Stash enables solvers to borrow liquidity with near zero collateral, and achieves this through a series of mechanisms below:

### 3. Request the final Credit Borrow Cost

If proceeding to fill with Sprinter Stash, call the [**Borrow Cost API**](borrow-cost-api) to request the final borrow cost to reserve credit and authorize the fill.

```ts title="Fetch Borrow Cost Example Payload"
const baseUrl = "https://api.sprinter.tech";
const destChainId = "eip155:8453"; // eip155:8453(Base), eip155:10 (Optimism), eip155:42161 (Arbitrum) destChainId must use capid format from our configuration
const protocol = "across"; // "across" or "mayan"
const txHash = "string"; // Source chain deposit TX
const response = await fetch(
`${baseUrl}/liquidity/chain/${destChainId}/protocol/${protocol}/deposit/${txHash}/requests`,
{
method: "GET",
headers: {
"X-Auth-Token": "<your_api_key>",
},
body: {
input: "callData", // encoded callData for destination ( Borrow & Fill) it also contains depositData prams for MPC validation
caller: "address", // the address that will execute the borrow and fill ond destChainId
},
},
);
```
#### 1. Approved Solvers

On launch only approved solvers can access Stash credit. These solvers:

- Undergo screening and onboarding by the Sprinter team
- Must use authenticated API keys tied to their accounts
- Are rate-limited and monitored to ensure responsible usage

Sprinter also tracks solver performance and creditworthiness over time. Solvers who consistently repay on time may be granted higher limits, while misbehavior results in penalties or revoked access with both informed through regular reviews of:

- Fill accuracy and repayment behavior
- Volume solved and protocols interacted with
- On-chain and off-chain repayment events

#### 2. Transaction-Level Guarantees

Each fill is validated against the user’s original intent using:

- Verified source deposits (e.g. via Across)
- MPC-signed authorization signatures
- Controlled function execution (via calldata)

### 4. Fill Optimization Tips
Sprinter acts as an intermediary: the solver never touches user funds directly. The system ensures that repayment is guaranteed by the user's transaction on the source chain before the solver receives liquidity.

Here are some tips on getting the best performance and profit from your Sprinter Stash integration:
#### 3. Protocol Guardrails & Limits

1. **Pre-fetch Borrow Cost** - Call `GET /type/{type}/quote` as early as possible (when detecting intents) to evaluate solver profitability.
Sprinter enforces:

- Per-solver daily limits (to minimize exposure)
- Per-transaction liquidity caps
- Circuit breakers triggered by irregular repayment behavior
- Slashing (or bond requirements) for higher-risk integrations

#### 4. Bonding Pools

Sprinter will also allow Solver Operators to create Bonding Pools, that escrow funds to vouch for their solvers, enabling more favourable borrowing conditions. Sprinter Bonding Pools will be controlled by governance and similarly allow slashing by governance for any malicious activity or violations.

## Stash Fees

Sprinter Stash handles crosschain liquidity fills. Revenue is generated from the spread between between the amount the user deposited on source and the amount provided on the destination.

### Revenue Components

- **Fill Revenue:** Amount user deposits on source - amount send to user on destination
- **Borrow Costs:** Cost of liquidity borrowing and crosschain repayment.
- **Solver Costs:** Gas fees and execution costs fronted by solvers.

### Profit Calculation

```
Fill Profit = Fill Revenue - Borrow Costs - Solver Costs
```

2. **Batch Gas Where Possible** - Bundle execution and repayment transactions to reduce gas costs.
### Monthly Distribution

3. **Optimize for Slippage** - Query quotes close to execution time to reduce stale pricing or slippage-induced fills.
1. Withdraw raw profits from liquidity pools.
2. Deduct solver gas costs.
3. Distribute monthly fill profits to:

4. **Handling Rate Limits** - If you hit 429s, give it a moment and retry using retry_after value. You can request higher limits via support@sprinter.tech.
| Actor | Description | Fill Profit % |
| -------- | ------------------------------------- | ------------- |
| Solvers | For executing fills | 50% |
| LPs | For providing liquidity | 50% |
| Treasury | Protocol growth & sustainability fund | TBD |

5. **Validate Transaction Hash Early** - Ensure the user intent transaction is final and not reverted before calling `/deposit/{txHash}/request`.
➡️ _Initial fee split is reviewed monthly by governance._
2 changes: 1 addition & 1 deletion docs/docs/02-Stash/02-stash-contracts.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ Liquidity authorization is managed and controlled by Sprinter's [**Multi-Party C
- **Incentive Layer** Bootstraps solver access to credit while ensuring LPs are fairly rewarded. Reward parameters can be updated through governance, and all emissions are transparently distributed on-chain.
- **Depositing Liquidity:** LPs deposit USDC → receive `spUSDC-LP` tokens.
- **Stashing** When LPs receive their `spUSDC-LP` tokens, they can stake them in this contract to participate in ongoing emissions programs.
**Multiplier incentives** — Longer lockups (e.g., 3, 6, or 9 months) offer higher SPRNT yield rates to encourage deeper liquidity commitments.
**Multiplier incentives** — Longer lockups (e.g., 3, 6, or 9 months) offer higher point multipliers to encourage deeper liquidity commitments.

## Liquidity Pools

Expand Down
Loading