Lexicon Garden

dev.cocore.account.tokenGrant

Records that an exchange has issued its one-time signup token grant to a recipient DID. Written by the exchange to its own PDS on the first balance event for a given DID — receipt as either side, top-up, or admission check. Issued exactly once per (exchange, recipient) pair. A consumer reconstructing balances offline starts each DID at this grant amount; absence of a tokenGrant record means the DID has never interacted with the exchange.

Repository @cocore.dev did:plc:5quuhkmwe2q4k3azfsgg7kdz namespace authority
Details · record, key tid
Kindrecord
Record keytid
Authorityaccount.cocore.dev
Indexed
Compare Edit in builder → Fork →
cid bafyreidxjiy5jihslfl7m536f6c5mlni5nkdjavdxjj7lr6tog2h4kfmny

Checks

Valid
  • missing-primary-description defs.mainThe record has no description.
JSONDownload
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "key": "tid",
      "record": {
        "properties": {
          "amount": {
            "description": "Tokens credited. Equal to the `tokenGrant` field of the policy in effect at issuance time.",
            "minimum": 0,
            "type": "integer"
          },
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "exchange": {
            "description": "Exchange DID. MUST equal the repo this record is published in.",
            "format": "did",
            "type": "string"
          },
          "policy": {
            "description": "Strong-ref to the exchangePolicy in effect when the grant was issued. Auditors verify `amount` against the policy's `tokenGrant`.",
            "ref": "com.atproto.repo.strongRef",
            "type": "ref"
          },
          "recipient": {
            "description": "The DID receiving the grant.",
            "format": "did",
            "type": "string"
          }
        },
        "required": [
          "exchange",
          "recipient",
          "amount",
          "policy",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "description": "Records that an exchange has issued its one-time signup token grant to a recipient DID. Written by the exchange to its own PDS on the first balance event for a given DID — receipt as either side, top-up, or admission check. Issued exactly once per (exchange, recipient) pair. A consumer reconstructing balances offline starts each DID at this grant amount; absence of a tokenGrant record means the DID has never interacted with the exchange.",
  "id": "dev.cocore.account.tokenGrant",
  "lexicon": 1
}