Partners
Partner overview
Integrate Uruk swaps into your app and earn a share of protocol fees.
Partner integration overview
Uruk lets partners embed buy/sell swaps for synthetic assets. Every swap can be tagged with your partner ID so fee revenue is split on-chain.
What you get
- On-chain attribution:
swap_exact_in(..., partner_id)credits your share via EarningsDistributor → PartnerRegistry - SDK:
@uruk.finance/partner-sdkfor listing assets, KYC, buy/sell, quoting, and swapping - APIs:
/api/sdk/assets,/api/sdk/contracts,/api/sdk/kyc/* - Dashboard: app.uruk.finance/partners (wallet must be the registered partner owner)
- Partner assets: submit a SEP-41 synth from the dashboard; DAO activates it before minting
Untagged vs partner swaps
| Call | Outcome |
|---|---|
partner_id = 0 (B2C / Uruk app without ?partner=) | Full protocol fee stays with Uruk |
partner_id > 0 | Partner share (default 50%) escrowed for claim; remainder to protocol |
Quick path
- Get approved by the DAO → receive a
partnerId(see Onboarding) - Install the SDK and point at the API (see Quickstart)
- Check KYC → start session (redirect / iframe / direct link) if needed
- Call
buyAsset/sellAsset(orswap) with yourpartnerId - Claim earnings from the Partner Dashboard (see Earnings and claims)