Class Arc3

Class representing an ARC-3 compliant NFT on Algorand. Extends CoreAsset with metadata handling for the ARC-3 standard.

Hierarchy (view full)

Constructors

constructor

Properties

assetParams id metadata

Methods

get getAmountInBaseUnits getAmountInDecimals getClawback getCreator getDecimals getDefaultFrozen getFreeze getIndex getManager getMetadata getMetadataHash getName getReserve getTotal getTotalSupply getUnitName getUrl getUrlProtocol hasClawback hasFreeze hasHttpUrl hasIpfsUrl hasManager hasReserve hasTemplateUrl hasValidName hasValidUrl isArc3 calculateSHA256 create fetchAssetParams fetchMetadata fromId resolveUrl

Constructors

Private constructor

  • new Arc3(id, params, metadata): Arc3

  • Creates an instance of Arc3.

    Parameters

    • id: number

      The asset ID

    • params: AssetParams

      The asset parameters from the Algorand blockchain

    • metadata: object

      The metadata associated with the asset

    Returns Arc3

Properties

assetParams

assetParams: AssetParams

The asset parameters retrieved from the Algorand blockchain

id

id: number

The asset ID on the Algorand blockchain

metadata

metadata: object

The metadata associated with this ARC-3 asset

Methods

get

  • get(): AssetParams

  • Gets the asset parameters

    Returns AssetParams

    The asset parameters

getAmountInBaseUnits

  • getAmountInBaseUnits(amount): number

  • Converts an amount from decimal-adjusted units to base units

    Parameters

    • amount: number

      The amount in decimal-adjusted units

    Returns number

    The amount in base units

getAmountInDecimals

  • getAmountInDecimals(amount): number

  • Converts an amount from base units to decimal-adjusted units

    Parameters

    • amount: number

      The amount in base units

    Returns number

    The amount adjusted for decimals

getClawback

  • getClawback(): string

  • Gets the clawback address of the asset

    Returns string

    The clawback address or the zero address if not set

getCreator

getDecimals

getDefaultFrozen

getFreeze

  • getFreeze(): string

  • Gets the freeze address of the asset

    Returns string

    The freeze address or the zero address if not set

getIndex

getManager

  • getManager(): string

  • Gets the manager address of the asset

    Returns string

    The manager address or the zero address if not set

getMetadata

  • getMetadata(): object

  • Gets the metadata associated with the asset

    Returns object

    The metadata object

getMetadataHash

getName

getReserve

  • getReserve(): string

  • Gets the reserve address of the asset

    Returns string

    The reserve address or the zero address if not set

getTotal

getTotalSupply

getUnitName

getUrl

getUrlProtocol

hasClawback

  • hasClawback(): boolean

  • Checks if the asset has a clawback address

    Returns boolean

    True if the asset has a clawback address

hasFreeze

  • hasFreeze(): boolean

  • Checks if the asset has a freeze address

    Returns boolean

    True if the asset has a freeze address

hasHttpUrl

  • hasHttpUrl(): boolean

  • Checks if the asset URL uses HTTP or HTTPS protocol

    Returns boolean

    True if the URL uses HTTP or HTTPS

hasIpfsUrl

hasManager

  • hasManager(): boolean

  • Checks if the asset has a manager address

    Returns boolean

    True if the asset has a manager address

hasReserve

  • hasReserve(): boolean

  • Checks if the asset has a reserve address

    Returns boolean

    True if the asset has a reserve address

hasTemplateUrl

hasValidName

  • hasValidName(): boolean

  • Checks if the asset has a valid ARC-3 name

    Returns boolean

    True if the asset name is ARC-3 compliant

hasValidUrl

  • hasValidUrl(): boolean

  • Checks if the asset has a valid ARC-3 URL

    Returns boolean

    True if the asset URL is ARC-3 compliant

isArc3

  • isArc3(): boolean

  • Checks if the asset is ARC-3 compliant

    Returns boolean

    True if the asset is ARC-3 compliant

Static Private calculateSHA256

  • calculateSHA256(blobContent): Promise<string>
  • Private

    Calculates the SHA256 hash of a file's content

    Parameters

    • blobContent: undefined | Blob

      The file content as a Blob

    Returns Promise<string>

    A promise resolving to the hex-encoded hash

Static create

  • create(options): Promise<{
        assetId: undefined | bigint;
        txid: string;
    }>

  • Creates a new ARC-3 compliant NFT on the Algorand blockchain

    Parameters

    • options: {
          clawback?: string;
          creator: {
              address: string;
              signer: TransactionSigner;
          };
          defaultFrozen?: boolean;
          freeze?: string;
          image: string;
          imageName: string;
          ipfs: IPFS;
          manager?: string;
          name: string;
          network: Network;
          properties: object;
          reserve?: string;
          unitName: string;
      }

      The configuration options for the NFT

      • Optional clawback?: string

        The clawback address

      • creator: {
            address: string;
            signer: TransactionSigner;
        }

        The creator of the asset, including address and signer

        • address: string
        • signer: TransactionSigner
      • Optional defaultFrozen?: boolean

        Whether the asset should be frozen by default

      • Optional freeze?: string

        The freeze address

      • image: string

        The path to the image file

      • imageName: string

        The name of the image file

      • ipfs: IPFS

        The IPFS instance to use for uploading

      • Optional manager?: string

        The manager address

      • name: string

        The name of the asset

      • network: Network

        The Algorand network to use

      • properties: object

        Additional properties to include in the metadata

      • Optional reserve?: string

        The reserve address

      • unitName: string

        The unit name for the asset

    Returns Promise<{
        assetId: undefined | bigint;
        txid: string;
    }>

    A promise resolving to an object containing the transaction ID and asset ID

Static fetchAssetParams

  • fetchAssetParams(id, network): Promise<AssetParams>

  • Fetches asset parameters from the Algorand blockchain

    Parameters

    • id: number

      The asset ID to fetch

    • network: Network

      The Algorand network to use

    Returns Promise<AssetParams>

    A promise resolving to the asset parameters

Static Protected fetchMetadata

  • fetchMetadata(url): Promise<object>

  • Fetches metadata from a given URL

    Parameters

    • url: string

      The URL to fetch metadata from

    Returns Promise<object>

    A promise resolving to the metadata object

Static fromId

  • fromId(id, network): Promise<Arc3>

  • Creates an Arc3 instance from an existing asset ID

    Parameters

    • id: number

      The asset ID to load

    • network: Network

      The Algorand network to use

    Returns Promise<Arc3>

    A promise resolving to an Arc3 instance

Static resolveUrl

  • resolveUrl(url, id): string

  • Resolves URLs, handling IPFS protocol and ID replacements

    Parameters

    • url: string

      The URL to resolve

    • id: number

      The asset ID to replace in the URL if needed

    Returns string

    The resolved URL

Settings

Member Visibility

Theme

On This Page

constructorassetParamsidmetadatagetgetAmountInBaseUnitsgetAmountInDecimalsgetClawbackgetCreatorgetDecimalsgetDefaultFrozengetFreezegetIndexgetManagergetMetadatagetMetadataHashgetNamegetReservegetTotalgetTotalSupplygetUnitNamegetUrlgetUrlProtocolhasClawbackhasFreezehasHttpUrlhasIpfsUrlhasManagerhasReservehasTemplateUrlhasValidNamehasValidUrlisArc3calculateSHA256createfetchAssetParamsfetchMetadatafromIdresolveUrl