Skip to main content
Version: 22.1.x

Class: Claims

api/client/Claims.Claims

Handles all Claims related functionality

Methods

addClaims

addClaims(args, opts?): Promise<GenericPolymeshTransaction<void, void>>

Add claims to Identities

Parameters

NameType
argsPick<ModifyClaimsParams, "claims">
opts?ProcedureOpts

Returns

Promise<GenericPolymeshTransaction<void, void>>

Note

required roles:

  • Customer Due Diligence Provider: if there is at least one CDD claim in the arguments

Note

this method is of type ProcedureMethod, which means you can call addClaims.checkAuthorization on it to see whether the signing Account and Identity have the required roles and permissions to run it

Defined in

api/client/Claims.ts:105


editClaims

editClaims(args, opts?): Promise<GenericPolymeshTransaction<void, void>>

Edit claims associated to Identities (only the expiry date can be modified)

Parameters

NameType
argsPick<ModifyClaimsParams, "claims">
opts?ProcedureOpts

Returns

Promise<GenericPolymeshTransaction<void, void>>

Note

required roles:

  • Customer Due Diligence Provider: if there is at least one CDD claim in the arguments

Note

this method is of type ProcedureMethod, which means you can call editClaims.checkAuthorization on it to see whether the signing Account and Identity have the required roles and permissions to run it

Defined in

api/client/Claims.ts:118


getCddClaims

getCddClaims(opts?): Promise<ClaimData <CddClaim>[]>

Retrieve the list of CDD claims for a target Identity

Parameters

NameTypeDescription
optsObject-
opts.includeExpired?booleanwhether to include expired claims. Defaults to true
opts.target?string | IdentityIdentity for which to fetch CDD claims (optional, defaults to the signing Identity)

Returns

Promise<ClaimData <CddClaim>[]>

Defined in

api/client/Claims.ts:313


getClaimScopes

getClaimScopes(opts?): Promise<ClaimScope[]>

Retrieve all scopes in which claims have been made for the target Identity. If the scope is an asset DID, the corresponding ticker is returned as well

Parameters

NameTypeDescription
optsObject-
opts.target?string | IdentityIdentity for which to fetch claim scopes (optional, defaults to the signing Identity)

Returns

Promise<ClaimScope[]>

Defined in

api/client/Claims.ts:264


getIdentitiesWithClaims

getIdentitiesWithClaims(opts?): Promise<ResultSet <IdentityWithClaims>>

Retrieve a list of Identities with claims associated to them. Can be filtered using parameters

Parameters

NameTypeDescription
optsObject-
opts.claimTypes?ClaimType[]types of the claims to fetch. Defaults to any type
opts.includeExpired?booleanwhether to include expired claims. Defaults to true
opts.scope?Scopescope of the claims to fetch. Defaults to any scope
opts.size?BigNumberpage size
opts.start?BigNumberpage offset
opts.targets?(string | Identity)[]Identities (or Identity IDs) for which to fetch targeting claims. Defaults to all targets
opts.trustedClaimIssuers?(string | Identity)[]Identity IDs of claim issuers. Defaults to all claim issuers

Returns

Promise<ResultSet <IdentityWithClaims>>

Note

supports pagination

Note

uses the middleware V2

Defined in

api/client/Claims.ts:179


getIssuedClaims

getIssuedClaims(opts?): Promise<ResultSet <ClaimData <Claim>>>

Retrieve all claims issued by an Identity

Parameters

NameTypeDescription
optsObject-
opts.includeExpired?booleanwhether to include expired claims. Defaults to true
opts.size?BigNumber-
opts.start?BigNumber-
opts.target?string | IdentityIdentity (optional, defaults to the signing Identity)

Returns

Promise<ResultSet <ClaimData <Claim>>>

Note

supports pagination

Note

uses the middlewareV2

Defined in

api/client/Claims.ts:144


getTargetingClaims

getTargetingClaims(opts?): Promise<ResultSet <IdentityWithClaims>>

Retrieve all claims issued about an Identity, grouped by claim issuer

Parameters

NameTypeDescription
optsObject-
opts.includeExpired?booleanwhether to include expired claims. Defaults to true
opts.scope?Scope-
opts.size?BigNumber-
opts.start?BigNumber-
opts.target?string | IdentityIdentity for which to fetch targeting claims (optional, defaults to the signing Identity)
opts.trustedClaimIssuers?(string | Identity)[]-

Returns

Promise<ResultSet <IdentityWithClaims>>

Note

supports pagination

Note

uses the middlewareV2 (optional)

Defined in

api/client/Claims.ts:372


revokeClaims

revokeClaims(args, opts?): Promise<GenericPolymeshTransaction<void, void>>

Revoke claims from Identities

Parameters

NameType
argsPick<ModifyClaimsParams, "claims">
opts?ProcedureOpts

Returns

Promise<GenericPolymeshTransaction<void, void>>

Note

required roles:

  • Customer Due Diligence Provider: if there is at least one CDD claim in the arguments

Note

this method is of type ProcedureMethod, which means you can call revokeClaims.checkAuthorization on it to see whether the signing Account and Identity have the required roles and permissions to run it

Defined in

api/client/Claims.ts:131