{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"codeGuideFiles":[],"seo":{"title":"Revenue settlement","description":"Learn how to work with Staking API for managing deposits, withdrawals, and stake pool information."},"dynamicMarkdocComponents":[],"metadata":{"type":"markdown"},"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"revenue-settlement"},"children":["Revenue settlement"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["This is the quick checklist for settling what you owe on TIN"]}," — tips (TCA), prepaid post-pack (PSA), and backrun / MevShare (MCA)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["detailed CLI flags and examples"]},", see the CLI docs linked in each section (and in the table below). Download the latest CLI from the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://github.com/rakurai-io/rakurai_programs/releases/latest"},"children":["releases"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Revenue flow: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/services/rakurai_jito_private/rakurai_docs/transaction_inclusion/readme#2.-revenue-streams"},"children":["TIN revenue streams"]},". Tip mechanics: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/services/rakurai_jito_private/rakurai_docs/transaction_inclusion/tips"},"children":["Tips"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Audience:"]}," Traders and landing services tipping for inclusion, and TIN partners on post-pack (PSA + MCA)."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Stream"},"children":["Stream"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Account"},"children":["Account"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"CLI"},"children":["CLI"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What you do"},"children":["What you do"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tips (Rakurai tip accounts)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["TCA"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nothing — settlement is automatic"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tips (partner tip account)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["TCA"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/services/rakurai_jito_private/rakurai_docs/rakurai_programs/cli/partner_reward_settlement"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rakurai-revshare"]}]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--revenue-kind Tip"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transfer after the epoch (interim; prefer Rakurai tip accounts)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Post-pack access"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PSA"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/services/rakurai_jito_private/rakurai_docs/rakurai_programs/cli/p2c_subscription"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rakurai-p2c"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Keep prepaid funded"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Backrun / MEV"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCA"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/services/rakurai_jito_private/rakurai_docs/rakurai_programs/cli/partner_reward_settlement"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rakurai-revshare"]}]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--revenue-kind Mev-share"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Record, then transfer"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"danger","name":"Settle within 2 epochs"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Partner tip TCA balances, P2C subscriptions, and backrun revenue must be settled within 2 epochs. Otherwise, the related TIN service may stop. Rakurai tip accounts do not need this manual step."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1.-tca--tips-collection-account"},"children":["1. TCA — Tips Collection Account"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tips for scheduling priority settle into a per-service, per-validator ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["TCA"]},". Prefer the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rakurai tip accounts"]}," path — settlement is automatic. A partner tip account is interim only and requires manual settlement each epoch."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1.1.-rakurai-tip-account-default--recommended"},"children":["1.1. Rakurai Tip Account (default & recommended)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Traders and transaction landing services tip any of ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/services/rakurai_jito_private/rakurai_docs/transaction_inclusion/tips#appendix-program-and-tip-account-addresses"},"children":["Rakurai’s eight tip accounts"]},". ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Nothing to settle from the trader or landing-service side."]}," Tip into a Rakurai tip account and you’re done. (",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Minimum recommended tip: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0.001 SOL"]}]},")"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1.2.-partner-tip-account-interim--prefer-rakurai-tip-accounts"},"children":["1.2. Partner Tip Account (interim — prefer Rakurai tip accounts)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Registering your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["own tip account"]}," is interim support only. The flow is more complex than Rakurai tip accounts (manually transfer each epoch). ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/services/rakurai_jito_private/rakurai_docs/transaction_inclusion/tips#appendix-program-and-tip-account-addresses"},"children":["Rakurai tip accounts"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you still use a partner tip account: traders tip into that account; tips stay with you — Rakurai cannot drain them."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["60% of the total tip"]}," is used for virtual priority"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each leader turn the validator ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["records"]}," that 60% in the TCA (no SOL moves yet)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After the epoch, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["you transfer"]}," the owed SOL into the TCA"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"1.2.1.-each-epoch"},"children":["1.2.1. Each epoch"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Wait for the epoch to end"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://github.com/rakurai-io/rakurai_programs/releases/latest"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rakurai-revshare"]}," CLI"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Inspect: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-all-accounts"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--revenue-kind Tip"]},") — view any pending record"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Settle: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transfer-all"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--dry-run"]}," first if needed) — settle the owed revenue"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Detailed commands: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/services/rakurai_jito_private/rakurai_docs/rakurai_programs/cli/partner_reward_settlement"},"children":["Tip and MevShare Settlement CLI"]},". Registration: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/services/rakurai_jito_private/rakurai_docs/transaction_inclusion/tips#4.-can-i-use-my-own-tip-account-instead-of-rakurais-eight-accounts"},"children":["custom tip accounts"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2.-psa--p2c-subscription"},"children":["2. PSA — P2C Subscription"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PSA"]}," is the prepaid subscription fee that keeps a validator’s post-pack (P2C) stream enabled. One PSA per ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["service"]},", per ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["validator"]},". The fee is priced from that validator’s ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["staked SOL"]}," and deducted when the epoch ends."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["selling P2C to searchers"]},", share ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["60-70%"]}," of that subscription revenue through TIN"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Expected baseline: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["$500 / month / 1M SOL stake"]}," (dollar equivalent amount in SOL)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use your own ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["RSMS / Revenue Recognition / Attribution System"]}," so you can provide audit report on Rakurai / validator request"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2.1.-each-epoch"},"children":["2.1. Each epoch"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://github.com/rakurai-io/rakurai_programs/releases/latest"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rakurai-p2c"]}," CLI"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fund ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["before"]}," the epoch ends: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fund-all"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["solana transfer"]}," to the PDA — keep the prepaid balance funded"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Wait for the epoch to end"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Inspect: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-all-accounts"]}," — view balance, total owed, status (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Active"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["InGrace"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Suspended"]},"), and any deficit"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Settle / top up: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fund-all"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--dry-run"]}," first if needed) — clear shortfalls so the stream stays active"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Suspended stops delivery"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Status ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Suspended"]}," means the stream has stopped until the shortfall is cleared. Updates missed while suspended are not replayed."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Detailed commands: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/services/rakurai_jito_private/rakurai_docs/rakurai_programs/cli/p2c_subscription"},"children":["P2C Subscription CLI"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"3.-mca--mevshare"},"children":["3. MCA — MevShare"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the PSA is funded, you consume P2C and can backrun. Profit stays with you during the epoch; you share it through the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCA"]},". Settlement is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["self-reported"]}," — you must hold the MCA ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["record_authority"]},"."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Backrun bundles using ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["P2C source transactions"]}," get a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["20% virtual priority boost"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Share ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["60-70%"]}," of backrun / MEV revenue through TIN"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Expected baseline: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["60-70 SOL / month / 1M stake"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use your own ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["RSMS / Revenue Recognition / Attribution System"]}," so you can provide audit report on Rakurai / validator request"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3.1.-each-epoch"},"children":["3.1. Each epoch"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Wait for the epoch to end"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://github.com/rakurai-io/rakurai_programs/releases/latest"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rakurai-revshare"]}," CLI"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Record: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["record-revenue"]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["once"]}," per validator (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--revenue-kind Mev-share"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["record_authority"]}," keypair) — ledger only, no SOL moves"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Inspect: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-all-accounts"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--revenue-kind Mev-share"]},") — view any pending record"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Settle: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transfer-all"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--dry-run"]}," first if needed) — settle the owed revenue"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Record once per validator per epoch"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["record-revenue"]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["adds"]}," to the epoch entry. Running it twice books twice what you owe — check with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-all-accounts"]}," before recording again."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Detailed commands: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/services/rakurai_jito_private/rakurai_docs/rakurai_programs/cli/partner_reward_settlement"},"children":["Tip and MevShare Settlement CLI"]},"."]}]},"headings":[{"value":"Revenue settlement","id":"revenue-settlement","depth":1},{"value":"1. TCA — Tips Collection Account","id":"1.-tca--tips-collection-account","depth":2},{"value":"1.1. Rakurai Tip Account (default & recommended)","id":"1.1.-rakurai-tip-account-default--recommended","depth":3},{"value":"1.2. Partner Tip Account (interim — prefer Rakurai tip accounts)","id":"1.2.-partner-tip-account-interim--prefer-rakurai-tip-accounts","depth":3},{"value":"1.2.1. Each epoch","id":"1.2.1.-each-epoch","depth":4},{"value":"2. PSA — P2C Subscription","id":"2.-psa--p2c-subscription","depth":2},{"value":"2.1. Each epoch","id":"2.1.-each-epoch","depth":3},{"value":"3. MCA — MevShare","id":"3.-mca--mevshare","depth":2},{"value":"3.1. Each epoch","id":"3.1.-each-epoch","depth":3}],"frontmatter":{"seo":{"title":"Revenue settlement"}},"lastModified":"2026-09-11T07:11:19.000Z"},"slug":"/docs/services/rakurai_jito_private/rakurai_docs/transaction_inclusion/revenue_settlement","userData":{"isAuthenticated":false,"teams":["anonymous"]}}