@arkade-os/sdk Documentation - v0.4.36
    Preparing search index...

    Type Alias SignerStatus

    SignerStatus:
        | "CURRENT"
        | "MIGRATABLE"
        | "DUE_NOW"
        | "EXPIRED"
        | "UNKNOWN_SIGNER"

    Machine-readable classification of a contract's server signer relative to a fresh ArkInfo snapshot. Drives both the migration selection (Section 3) and the user-facing cutoff reporting (Section 6) without persisting any stale-key metadata: staleness is always derived at read time from the contract's params.serverPubKey plus the server's advertised signer set.

    • CURRENT: the contract was minted under the server's active signer; no migration needed.
    • MIGRATABLE: the contract's signer is advertised as deprecated and its cutoff has not passed — cooperative migration is still possible.
    • DUE_NOW: the contract's signer is advertised as deprecated with no cutoff date (arkd advertises this as a 0n cutoff), so migration should start immediately.
    • EXPIRED: the contract's signer is deprecated and its cutoff has passed — cooperative migration is closed. These funds are NOT stranded: the VTXO keeps its own batch expiry, the server sweeps that batch at expiry, and the swept VTXO then recovers into the active signer through the normal recovery settle (no deprecated key, no forfeit, no on-chain exit). Unilateral exit remains an opt-in escape hatch, not a requirement (Section 6 / post-cutoff).
    • UNKNOWN_SIGNER: the contract's signer is neither the active signer nor an advertised deprecated signer. The SDK does not attempt to migrate these.