Skip to main content
Version: v28.0.x

Class: DefaultPortfolio

api/entities/DefaultPortfolio.DefaultPortfolio

Represents the default Portfolio for an Identity

Hierarchy

Properties

owner

owner: Identity

The Identity that owns this Portfolio

Inherited from

Portfolio.owner

Defined in

api/entities/Portfolio/index.ts:69


uuid

uuid: string

Inherited from

Portfolio.uuid

Defined in

api/entities/Entity.ts:46

Methods

exists

exists(): Promise<boolean>

Determine whether this Portfolio exists on chain

Returns

Promise<boolean>

Overrides

Portfolio.exists

Defined in

api/entities/DefaultPortfolio.ts:22


getAssetBalances

getAssetBalances(args?): Promise<PortfolioBalance[]>

Retrieve the balances of all fungible assets held in this Portfolio

Parameters

NameTypeDescription
args?Object-
args.assets(string | FungibleAsset)[]Optional array of tickers or FungibleAsset instances to filter the results by. If not provided, all balances are returned

Returns

Promise<PortfolioBalance[]>

An array of PortfolioBalance objects representing total, locked, and free amounts for each asset

Inherited from

Portfolio.getAssetBalances

Defined in

api/entities/Portfolio/index.ts:133


getCollections

getCollections(args?): Promise<PortfolioCollection[]>

Retrieve all NFT holdings in this Portfolio

Parameters

NameTypeDescription
args?Object-
args.collections(string | NftCollection)[]Optional array of tickers, asset IDs, or NftCollection instances to filter by. If not provided, returns all holdings

Returns

Promise<PortfolioCollection[]>

An array of PortfolioCollection objects, including held, locked, and free NFTs per collection

Inherited from

Portfolio.getCollections

Defined in

api/entities/Portfolio/index.ts:214


getCustodian

getCustodian(): Promise<Identity>

Retrieve the current custodian of this Portfolio's identity

Returns

Promise<Identity>

Note

If no custodian is explicitly assigned, the Portfolio owner is returned

Inherited from

Portfolio.getCustodian

Defined in

api/entities/Portfolio/index.ts:345


getTransactionHistory

getTransactionHistory(filters?): Promise<HistoricSettlement[]>

Retrieve the transaction history of this Portfolio, optionally filtered by account, ticker, or assetId

Parameters

NameTypeDescription
filtersObject-
filters.account?string(optional) Account address to filter transactions by
filters.assetId?string(optional) Asset ID to filter by. Overrides ticker if both are present
filters.ticker?string(optional) Asset ticker involved in the transaction

Returns

Promise<HistoricSettlement[]>

Note

Uses the middlewareV2 GraphQL API

Inherited from

Portfolio.getTransactionHistory

Defined in

api/entities/Portfolio/index.ts:388


isCustodiedBy

isCustodiedBy(args?): Promise<boolean>

Check whether a given Identity is the custodian of this Portfolio

Parameters

NameTypeDescription
args?Object-
args.identitystring | IdentityIdentity or DID string to compare. Defaults to the signing Identity

Returns

Promise<boolean>

Inherited from

Portfolio.isCustodiedBy

Defined in

api/entities/Portfolio/index.ts:115


isEqual

isEqual(entity): boolean

Determine whether this Entity is the same as another one

Parameters

NameType
entityEntity<unknown, unknown>

Returns

boolean

Inherited from

Portfolio.isEqual

Defined in

api/entities/Entity.ts:61


isOwnedBy

isOwnedBy(args?): Promise<boolean>

Check whether a given Identity is the owner of this Portfolio

Parameters

NameTypeDescription
args?Object-
args.identitystring | IdentityIdentity or DID string to compare. Defaults to the signing Identity

Returns

Promise<boolean>

Inherited from

Portfolio.isOwnedBy

Defined in

api/entities/Portfolio/index.ts:102


moveFunds

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

Move funds from this Portfolio to another Portfolio owned by the same Identity

Parameters

NameType
argsMoveFundsParams
opts?ProcedureOpts

Returns

Promise<GenericPolymeshTransaction<void, void>>

Note

required role:

  • Portfolio Custodian

Note

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

Inherited from

Portfolio.moveFunds

Defined in

api/entities/Portfolio/index.ts:323


quitCustody

quitCustody(opts?): Promise<GenericPolymeshTransaction<void, void>>

Unilaterally return custody of the Portfolio to its owner

Parameters

NameType
opts?ProcedureOpts

Returns

Promise<GenericPolymeshTransaction<void, void>>

Note

required role:

  • Portfolio Custodian

Note

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

Inherited from

Portfolio.quitCustody

Defined in

api/entities/Portfolio/index.ts:336


toHuman

toHuman(): HumanReadable

Convert this Portfolio's identifiers to a human-readable format

Returns

HumanReadable

An object containing the owner DID and (if applicable) the Portfolio ID as strings

Inherited from

Portfolio.toHuman

Defined in

api/entities/Portfolio/index.ts:465


generateUuid

Static generateUuid<Identifiers>(identifiers): string

Generate the Entity's UUID from its identifying properties

Type parameters

Name
Identifiers

Parameters

NameType
identifiersIdentifiers

Returns

string

Inherited from

Portfolio.generateUuid

Defined in

api/entities/Entity.ts:14


unserialize

Static unserialize<Identifiers>(serialized): Identifiers

Unserialize a UUID into its Unique Identifiers

Type parameters

Name
Identifiers

Parameters

NameTypeDescription
serializedstringUUID to unserialize

Returns

Identifiers

Inherited from

Portfolio.unserialize

Defined in

api/entities/Entity.ts:23