Skip to content
DigiStamp Contracts, home

⚠️ NOTICE: Deployment Testing in Progress We have recently deployed a major platform update and are currently performing post-deployment testing and validation. Please do not use this website or submit any transactions until testing is complete. Some features may be unavailable or behave unexpectedly. Thank you for your patience as we work to ensure everything is functioning correctly.

← Template gallery

DigiAsset holder-gated access

While the member holds a pass DigiAsset (as DigiAsset indexers see it), a DigiPass on DigiStamp Assets grants them access.

Accessdigiassetmembershipdigipasstoken-gatingholder-gated-access v1

Who enforces what

  • Condition holds Asset heldDigiAsset-indexer-enforcedpreview
  • Action grant Activate a utilityApplication-enforcedpreview
  • Action grant Record the outcomeApplication-enforced
Consensus-enforced
Every DigiByte node enforces it. Nobody can override it, including Contracts.
DigiAsset-indexer-enforced
DigiAsset indexers apply it after a transaction confirms. It is not DigiByte consensus: a valid DigiByte transaction can still be treated as burning assets.
Application-enforced
Contracts decides it in its own application, from data you can check. You trust Contracts' nodes, records and evaluation.
Cryptographically verifiable
Anyone can check it from public data and mathematics alone (wallet signatures, drand). Contracts records it; you need not trust Contracts to verify it.

Before it can be signed, fill in

  • a DigiByte address for every party
  • the pass DigiAsset id
  • the Assets DigiPass definition id

Simulation

The standard scenarios, run through the same rule engine the live service uses, with example values in every blank (addresses nobody holds keys for, and a format-valid example asset).

ScenarioOutcomeActions

Nothing happens

Everyone signs, then nobody does anything until expiry.

lapsednone

Holds the pass: grant access happens

The least that makes rule “Holds the pass: grant access” true happens at block 24500005.

stops: failed
grant: activate utility (preview)
grant: update contract state (cancelled)

Data unavailable

The rule conditions are met, but every outside data source is unreachable. Nothing irreversible may happen.

nonenone

Rules

  1. 1. Holds the pass: grant access

    When “holds”

    • → Activate the DIGIPASS on Example pass for the member.Application-enforcedIrreversiblePreview
    • → Record the outcome: fulfilled. The contract ends.Application-enforcedIrreversible
  2. Expiry

    At DigiByte block 24,540,320 (20 confirmations), if no outcome has been recorded, the contract ends as lapsed. Nothing that happens at or after expiry counts.

Conditions

  • holdsAsset heldDigiAsset-indexer-enforcedPreview: monitored in a later release

    The member holds at least 1 units of Example pass, with 20 confirmations.

    Ownership is decided by DigiAsset indexers; Contracts reads it from its own DigiAsset Core and decides whether the condition holds.

    • A confirmed DigiByte transaction is not always a valid DigiAsset transfer: indexers burn assets when an asset's rules are broken.
    • Assets that carry on-chain rules (royalties, approvals, KYC, expiry) are treated as UNKNOWN until those rules are modelled.

What you are trusting

DigiByte itself does not enforce these rules. Contracts evaluates them from public data and records the outcome; the parties’ signatures and any anchors can be checked by anyone.

  • Contracts' evaluation and records
  • Contracts' DigiAsset Core indexer
  • Contracts' evaluation
  • DigiStamp Assets' Utility Engine

Irreversible once done

  • Holds the pass: grant access: Activate the DIGIPASS on Example pass for the member.
  • Holds the pass: grant access: Record the outcome: fulfilled. The contract ends.

These run only when every condition they depend on is known. Missing or unconfirmed data never triggers them.

Some parts are in preview: they are part of the agreement, but Contracts will monitor or perform them only once that feature launches.

Use it from code

The same template is available from the API (GET /api/contracts/v1/templates/holder-gated-access) and the TypeScript SDK:

const { draft } = await client.templates.get("holder-gated-access");
// fill in addresses, asset ids and amounts, then:
const { id } = await client.contracts.create(draft, { idempotencyKey: crypto.randomUUID() });