⚠️ 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.
DigiAsset holder-gated access
While the member holds a pass DigiAsset (as DigiAsset indexers see it), a DigiPass on DigiStamp Assets grants them access.
holder-gated-access v1Who enforces what
- Condition
holdsAsset heldDigiAsset-indexer-enforcedpreview - Action
grantActivate a utilityApplication-enforcedpreview - Action
grantRecord 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).
| Scenario | Outcome | Actions |
|---|---|---|
Nothing happens Everyone signs, then nobody does anything until expiry. | lapsed | none |
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. | none | none |
Rules
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
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 releaseThe 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() });