diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 7f8fce9..4fa7331 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -9,10 +9,9 @@ ## [0.4.0](https://github.com/sprintertech/sprinter-sdk/compare/docs-v0.3.12...docs-v0.4.0) (2025-11-11) - ### Features -* add points program to docs ([#195](https://github.com/sprintertech/sprinter-sdk/issues/195)) ([80019d5](https://github.com/sprintertech/sprinter-sdk/commit/80019d5046ba9b3063f57f224858901d33f165e2)) +- add points program to docs ([#195](https://github.com/sprintertech/sprinter-sdk/issues/195)) ([80019d5](https://github.com/sprintertech/sprinter-sdk/commit/80019d5046ba9b3063f57f224858901d33f165e2)) ## [0.3.12](https://github.com/sprintertech/sprinter-sdk/compare/docs-v0.3.11...docs-v0.3.12) (2025-10-31) diff --git a/docs/docs/02-Stash/01-utilizing-stash.md b/docs/docs/02-Stash/01-utilizing-stash.md index 6448676..1dc63d2 100644 --- a/docs/docs/02-Stash/01-utilizing-stash.md +++ b/docs/docs/02-Stash/01-utilizing-stash.md @@ -37,74 +37,3 @@ style E fill:#FF9B43,stroke:#333,stroke-width:2px,color:#000,font-weight:bold ``` - -## How Stash Enables Zero-Collateral Loans - -Sprinter Stash enables solvers to borrow liquidity with near zero collateral, and achieves this through a series of mechanisms below: - -#### 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) - -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. - -#### 3. Protocol Guardrails & Limits - -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 -``` - -### Monthly Distribution - -1. Withdraw raw profits from liquidity pools. -2. Deduct solver gas costs. -3. Distribute monthly fill profits to: - -| Actor | Description | Fill Profit % | -| -------- | ------------------------------------- | ------------- | -| Solvers | For executing fills | 50% | -| LPs | For providing liquidity | 50% | -| Treasury | Protocol growth & sustainability fund | TBD | - -➡️ _Initial fee split is reviewed monthly by governance._ diff --git a/docs/docs/02-Stash/index.md b/docs/docs/02-Stash/index.md index b9363ff..37ab8d7 100644 --- a/docs/docs/02-Stash/index.md +++ b/docs/docs/02-Stash/index.md @@ -44,6 +44,81 @@ By bringing together **liquidity providers and solvers** Sprinter Stash creates - **Protocols** - Any EVM crosschain bridge/ swap protocol such as 1inch Fusion+, Across, Debridge Liquidity Network, Everclear, Mayan.Finance with many more upcoming - **Rebalancing/ Inventory Management** - CCTP, native Bridges, Everclear +## How Stash Enables Zero-Collateral Loans + +Sprinter Stash enables solvers to borrow liquidity with near zero collateral, and achieves this through a series of mechanisms below: + +#### 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) + +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. + +#### 3. Protocol Guardrails & Limits + +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. Solver Risk / Repayment + +Stash pools initiate the execution, not the solver. The solver does not pull funds itself, but merely instruct the pool and as such never custody capital. There are no scenarios where a solver can “not execute” or misdirect funds. + +#### 5. Liquidity Proivder Risk + +Stash is a closed credit system with controlled flows, so solvers cannot lose LP funds. The remaining risks are the same as any DeFi protocol: Security risks in Stash itself and in the protocols we use (e.g. Aave). We only integrate with partners who meet strict security standards and have strong audit histories as ourselves. + +## 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 +``` + +### Monthly Distribution + +1. Withdraw raw profits from liquidity pools. +2. Deduct solver gas costs. +3. Distribute monthly fill profits to: + +| Actor | Description | Fill Profit % | +| -------- | ------------------------------------- | ------------- | +| Solvers | For executing fills | 50% | +| LPs | For providing liquidity | 50% | +| Treasury | Protocol growth & sustainability fund | TBD | + +➡️ _Initial fee split is reviewed monthly by governance._ + # Ready to Stash? - As a Liquidity Provider: check out [Track Event 1](/Stash-points) diff --git a/docs/docs/05-points.md b/docs/docs/05-points.md index 9bb4409..626dddc 100644 --- a/docs/docs/05-points.md +++ b/docs/docs/05-points.md @@ -78,3 +78,13 @@ You earn from: Your browser does not support the video tag. + +## Sprinter LP participation + +From time to time, the Sprinter team will move treasury funds into the Stash liquidity pools from its Treasury wallet for various reasons such as: + +- the provision of additional liquidity for new solver routes or protocol usage, +- rebalancing or, +- participating in yield strategies + +Sprinter's participation will not be Stashed, and therefore not be eligible for any Stash Points.