API reference

Conventions

Pacts

GET /drops/pacts/capabilities

The machine-readable capability boundary. Read this before building anything against Pacts. Every execution, custody, authorization, signature, broadcast, live-Cell, off-chain-policy and value-bearing authority field is false.

{
  "schemaVersion": 1,
  "mode": "reference",
  "supported": {
    "verifiedDrops": true,
    "recordedPactSeeds": true,
    "pactsReferences": true,
    "deterministicPrimitives": true,
    "localProofPackValidation": true
  },
  "authority": {
    "pactCell": false,
    "liveCells": false,
    "transaction": false,
    "authorization": false,
    "signature": false,
    "signatures": false,
    "broadcast": false,
    "custody": false,
    "contractExecution": false,
    "enforceableOffChainPolicy": false,
    "valueBearingPacts": false,
    "valueBearingAuthority": false
  },
  "recovery": {
    "status": "reference_only",
    "message": "...",
    "actions": ["..."]
  }
}

Every value shown is a constant in the interface definition, not an example. An implementation that returns anything else for these fields is not the reference Pacts surface.

GET /drops/pacts

List recorded immutable Pact Seeds, newest first. One query parameter: limit (integer 1 to 100, default 50). There is no offset parameter on this endpoint. The response carries data (array of PactDropRecord), count (0 to 100), notice (the reference-only notice string), and capability (the full capability object above).

GET /drops/pacts/{pactId}

Fetch one Pact Seed record. Path parameter pactId must match ^[0-9a-f]{64}$. Responses: 200 with a PactDropRecord, or 404.

Schemas

DropsInscription

PactDropRecord

Required: id, number, marker, network, contentType, contentHash, dropmark, bodyHex, creatorPubkey, reveal, anchor, verification, finality, indexedAt.

• network is one of mainnet, testnet, signet, regtest.
• number is a presentation number, explicitly not an identity.
• contentHash and creatorPubkey match ^[0-9a-f]{64}$; bodyHex matches ^(?:[0-9a-f]{2})+$.
• verification.taprootCommitted is the constant true. A record only exists if its commitment verified.
• finality.status is the constant finalized. Note that finalizedAt is typed as always null in the current definition, so do not rely on it for a timestamp; use reveal.height instead.
• pactSeed and pactsReference appear when the body decoded as one of those profiles.

PactSeed

All of pactId, rulesetHash, abiHash, genesisStateRoot, policyRoot and dataAvailabilityPolicyHash match ^[0-9a-f]{64}$. engineId matches ^[a-z][a-z0-9-]{0,15}$. enforcementFloor is one of recorded, co-signed, template-enforced. Every field is required.

PactsReference

template matches ^[a-z][a-z0-9-]{0,40}$; planHash and blueprintHash each match ^[0-9a-f]{64}$. All three are required.

Error

{ "statusCode": 404, "error": "Not Found", "message": "..." }

The shape is open and none of the three fields is formally required, so a client should treat all three as optional and fall back to the HTTP status. The only structured error code on the Drops and Pacts surface is PACTS_REFERENCE_READ_ONLY, returned with 405.