UNRENT

Where Solana's rent reduction (SIMD-0437) stands: the live lamports_per_byte, which of the five steps are live, and when the next is expected. Older accounts keep their higher deposit until it is withdrawn; each step makes more SOL reclaimable.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Reads the token accounts and mints of a Solana wallet and returns the SOL that can be reclaimed now: excess rent (WithdrawExcessLamports, accounts stay open), empty token accounts (CloseAccount) and mint excess, the UNRENT service fee, the net amount, a forecast for the remaining rent steps, and tokens that may optionally be burned and closed (dust). Read-only, needs no signature. Amounts are in SOL. Also returns signUrl: a link to finish the reclaim on unrent.xyz with a browser wallet (Phantom, Solflare, Backpack…), for when you cannot sign for the wallet yourself.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana wallet address (base58)."
    },
    "ref": {
      "description": "Optional UNRENT referral code. The referrer gets a share of the service fee; the wallet pays the same.",
      "type": "string",
      "maxLength": 32
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Re-scans the wallet on the chain and builds the reclaim as unsigned, simulated Solana transactions (base64, versioned). They withdraw excess rent, close empty accounts and pay the service fee as the last instruction; nothing else leaves the wallet. Tokens are only burned for accounts listed in `burn`. The wallet's owner signs every transaction unchanged (the fee payer is the wallet, compute budget instructions may be added) and passes them to submit_reclaim within about 60 seconds, before the blockhash expires. Do not send them yourself.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana wallet address (base58)."
    },
    "accounts": {
      "description": "Only these account addresses (from a scan). Default: everything reclaimable.",
      "maxItems": 2000,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "burn": {
      "description": "Token accounts to burn and close (from the scan's burn.candidates). Only when the wallet owner explicitly asked for it.",
      "maxItems": 2000,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "burnMaxUsd": {
      "description": "Highest USD value per account that may be burned (capped by burn.cleanupMaxUsd). Dust is burned regardless.",
      "type": "number",
      "minimum": 0,
      "maximum": 1000
    },
    "ref": {
      "description": "Optional UNRENT referral code. The referrer gets a share of the service fee; the wallet pays the same.",
      "type": "string",
      "maxLength": 32
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Checks the signed transactions against the ones build_reclaim made (same instructions, same fee, signed by the wallet) and sends them to Solana. Returns the signature and status of every transaction. A claim can be submitted once; after an expired blockhash, build again.

{
  "type": "object",
  "properties": {
    "claimId": {
      "type": "string",
      "minLength": 10,
      "maxLength": 32,
      "description": "claimId from the build."
    },
    "signed": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 4000
      },
      "description": "The signed transactions, base64, in the order the build returned them."
    }
  },
  "required": [
    "claimId",
    "signed"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}