Skip to main content

Class: Stamper

Defined in: core-sdk/src/stamper/stamper.ts:43

Stateful postage stamp issuer: tracks how many chunks have been stamped into each of the batch's 65536 buckets, so each chunk gets a distinct, capacity-respecting index without the caller managing that bookkeeping.

Properties​

batchId​

batchId: BatchId

Defined in: core-sdk/src/stamper/stamper.ts:45


buckets​

buckets: Uint32Array

Defined in: core-sdk/src/stamper/stamper.ts:46


depth​

depth: number

Defined in: core-sdk/src/stamper/stamper.ts:47


maxSlot​

maxSlot: number

Defined in: core-sdk/src/stamper/stamper.ts:48


signer​

signer: PrivateKey

Defined in: core-sdk/src/stamper/stamper.ts:44

Methods​

getState()​

getState(): Uint32Array

Defined in: core-sdk/src/stamper/stamper.ts:102

Returns the live bucket-height state, for persisting and later resuming via fromState.

Returns​

Uint32Array


stamp()​

stamp(address, timestampMs?): EnvelopeWithBatchId

Defined in: core-sdk/src/stamper/stamper.ts:85

Stamps a chunk address, automatically picking and reserving the next free slot in its bucket. Throws once a bucket reaches its depth-derived capacity.

Parameters​

address​

Uint8Array

timestampMs?​

number

Returns​

EnvelopeWithBatchId


fromBlank()​

static fromBlank(signer, batchId, depth): Stamper

Defined in: core-sdk/src/stamper/stamper.ts:61

Creates a fresh Stamper for a batch with no chunks stamped yet.

Parameters​

signer​

string | Uint8Array<ArrayBufferLike> | PrivateKey

batchId​

string | Uint8Array<ArrayBufferLike> | BatchId

depth​

number

Returns​

Stamper


fromState()​

static fromState(signer, batchId, buckets, depth): Stamper

Defined in: core-sdk/src/stamper/stamper.ts:72

Resumes a Stamper from a previously persisted bucket state (see getState).

Parameters​

signer​

string | Uint8Array<ArrayBufferLike> | PrivateKey

batchId​

string | Uint8Array<ArrayBufferLike> | BatchId

buckets​

Uint32Array

depth​

number

Returns​

Stamper

💬 Get Help