Guides

Open a remit in the app

Set an amount, the caps, the payees and the expiry, and hand the agent the one key that spends it.

Opening a remit moves an amount out of your private balance and sets it aside for one agent key, with terms. At the end the remit exists, the agent key can pay from it, and you have its page with the statement.

You need a private balance with the amount in it: Deposit and withdraw a private balance.

  1. Open the form

    Go to Open a remit.

  2. Make the agent's key

    Under Agent key, leave Generate one here selected and press Generate a key. The app shows one line:

    Shell
    REMIT_AGENT_KEY=<the agent's secret key>

    Press Copy the env line and put it where the agent's environment is set. It is shown once and does not appear again after the remit is opened.

    If the agent already has a key, choose Paste an address and paste the agent's private address.

  3. Set the amount

    Amount is what the remit holds. The hint shows what your private balance has.

  4. Set the caps

    Cap per payment is the most one payment can be. Cap per day is the most the agent can pay in one UTC day. The day's cap is at least the cap per payment, and neither is more than the amount.

  5. Choose the payees

    With Only these payees selected, search the directory by name or URL and tick each payee the agent may pay. Each row shows the payee's settled count. Add payees that are not in the directory under Other payees, one address per line. A remit takes up to 32.

    Any payee lets the agent pay any address.

  6. Set the expiry and the fee SOL

    Expires in is 1, 7, 30 or 90 days. SOL for the agent's transaction fees is 0.01, 0.05 or 0.2 SOL, sent from your wallet to the agent key so it can pay for its own transactions.

  7. Review

    Press Review. The form locks and the panel on the right lists the terms. Under them:

    • What the chain will show: that your wallet opened a remit, and the SOL sent to the agent key.
    • Encrypted: the amount, both caps, the payee list, the expiry.

    Edit unlocks the form.

  8. Open the remit

    Press Open the remit and approve the transaction. The line moves through Proving, Signing, Sending and Confirmed. Then press Go to the remit.

The remit's page shows what remains, the terms and an empty statement. The agent can pay from this moment.

The terms cannot be edited

A remit's terms are fixed when it opens. To give the agent a larger budget, other payees or a later expiry, revoke the remit and open another. The same agent key can be pasted into the new one.

What can stop it

MessageWhat to do
"Your private balance is empty. Deposit first"Follow the link and deposit.
"Your private balance holds …"The amount is more than the balance.
"Larger than the remit itself."The cap per payment is more than the amount.
"Smaller than the cap per payment."The cap per day is less than the cap per payment.
"Pick at least one payee, or allow any payee."Tick a payee, paste an address, or choose Any payee.
"One of the pasted addresses is not a Solana address."Check the lines under Other payees.

With the SDK

TypeScript
import { createOwner } from '@remit/sdk'

const owner = createOwner({ keys: process.env.OWNER_SECRET_KEY! })

const { remitId } = await owner.open({
  agent: { shieldedAddress: process.env.AGENT_PRIVATE_ADDRESS! },
  mint: process.env.MINT!,
  amount: '20000000',
  perPaymentCap: '500000',
  dailyCap: '5000000',
  payees: ['<payee address>', '<payee address>'],
  expiresAt: Math.floor(Date.now() / 1000) + 30 * 86_400,
  agentFeeLamports: '50000000',
})
console.log(remitId)

The agent's private address comes from POST /v1/engine/keys/address with the agent's key. SDK lists every field.

Loading the index