A materialized view of a UCAN delegation, which can be encoded into a UCAN token and used as proof for an invocation or further delegations.

Type Parameters

Hierarchy

Implemented by

Properties

asCID: Link<C, MulticodecCode<number, string>, SigAlg>
audience: Principal<`did:${string}:${string}`>
blocks: Map<string, Block<unknown, any, any, any>>

Map of all the IPLD blocks that were included with this delegation DAG. Usually this would be blocks corresponding to proofs, however it may also contain other blocks e.g. things that capabilities or facts may link. It is not guaranteed to include all the blocks of this DAG, as it represents a partial DAG of the delegation desired for transporting.

Also note that map may contain blocks that are not part of this delegation DAG. That is because Delegation is usually constructed as view / selection over the CAR which may contain bunch of other blocks.

Deprecated

bytes: ByteView<UCAN<C>>
capabilities: C
cid: Link<C, MulticodecCode<number, string>, SigAlg>
data: View<C>
expiration: number
facts: Fact[]
issuer: Principal<`did:${string}:${string}`>
nonce?: string
notBefore?: number
proofs: Proof<Capabilities>[]
root: Block<C, MulticodecCode<number, string>, SigAlg>

The root block of the IPLD DAG this is the view of. This is the the block from which all other blocks are linked directly or transitively.

signature: SignatureView<unknown, SigAlg>
version: `${number}.${number}.${number}`

Methods

  • Returns Await<Result<Uint8Array, Error>>

  • Attach a block to the delegation DAG so it would be included in the block iterator. ⚠️ You can only attach blocks that are referenced from the capabilities or facts.

    Parameters

    • block: Block<unknown, number, number, 1>

    Returns void

  • Encodes all the blocks and creates a new IPLDView instance over them. Can be passed a multihasher to specify a preferred hashing algorithm. Note that there is no guarantee that preferred hasher will be used, it is only a hint of preference and not a requirement.

    Parameters

    Returns Await<Delegation<C>>

  • Returns Await<Delegation<C>>

  • Returns IterableIterator<Block<unknown, number, number, 1>>

  • Returns an iterable of all the IPLD blocks that are included in this view. It is RECOMMENDED that implementations return blocks in bottom up order (i.e. leaf blocks first, root block last).

    Iterator MUST include the root block otherwise it will lead to encoders into omitting it when encoding the view into a CAR archive.

    Note that we would like to rename this method to blocks but that would be a breaking change on the Delegate API so we defer it for now.

    Returns IterableIterator<Block<unknown, number, number, 1>>

Generated using TypeDoc