Add K2 lending protocol to the ecosystem reference - #77
Open
kaankacar wants to merge 1 commit into
Open
Conversation
K2 is a live Soroban money market (modular router, Aave V3-inspired) that was missing from the Lending & Borrowing section, so agents asking about Stellar lending only saw Blend and Slender. The entry covers what an integrator actually needs: the aToken / debt ledger position model and index-based accrual, the two-slope rate curve and supply-rate formula, risk parameters (liquidation thresholds, health factor cutoffs, close-factor exceptions, bonuses), the fee schedule, the RedStone-primary / Reflector-fallback oracle stack with its staleness and circuit-breaker behavior, flash-loan mechanics, and the Soroswap + Aquarius collateral-swap path including the direct-pairs-only limitation. Includes the mainnet contract addresses: the router entry point and its modules, plus the underlying/aToken/debt-ledger triplet for each of the four live markets, and the external oracle contracts K2 reads. All 27 addresses were copied from docs.k2lend.com/contracts and each one was resolved live on pubnet before being written. Legacy reserve tokens and published-but-uninstantiated WASM hashes are left out with a pointer to the docs page as source of truth. Also flags that wBTC appears in K2's risk tables but has no published reserve token set, so only the four documented markets should be treated as live.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds K2 (k2lend.com, docs) to
skills/standards/SKILL.mdunder DeFi Protocols → Lending & Borrowing, where it sits alphabetically between Blend and Slender. It's a live Soroban money market and was missing entirely, so an agent asked about lending on Stellar only ever saw Blend and Slender.What the entry covers
Beyond the usual links, the things an integrator has to know before writing a line of code:
scaled balance × current index, with separate liquidity and borrow indices and index updates on first touch per ledgerSupply Rate = Borrow Rate × Utilization × (1 − Reserve Factor)formulaContract addresses
The entry lists the mainnet addresses:
kinetic_router(the entry point) and its modules, the underlying/aToken/debt-ledger triplet for each of the four live markets, and the external oracle contracts K2 reads.Verification: all 27 addresses were taken from docs.k2lend.com/contracts and then each one was independently resolved on pubnet before being written into the file — every one exists. I also byte-compared what I wrote against the source table to rule out transcription slips (27 written, 27 unique, 0 mismatches). The K2-owned contracts were created in 2026; the USDC and XLM underlying SACs date to Feb 2024, which is the pattern you'd expect and a good sanity signal. Cross-check: the USDC SAC matches the
USDC_PUBNET_ADDRESSalready documented inskills/agentic-payments/SKILL.md.Legacy manual reserve tokens and published-but-uninstantiated WASM hashes are deliberately omitted, with the docs page named as source of truth and a note to re-check before hard-coding since reserves and adapters can rotate.
Two things I chose to be careful about
Checks
pnpm lint,pnpm lint:ts, andpnpm buildall pass; the built output serves the updated skill (site/out/skills/standards/SKILL.md). Skill-content change only — no site code, no card changes, and the skill's frontmatter description already covers DeFi protocol references so it needed no edit.