IHTSAdapter

Git Source

Title: IHTSAdapter

Author: Modified from hiero-ledger/hiero-contracts (https://github.com/hiero-ledger/hiero-contracts)

Interface for the HTSAdapter Diamond facet — the diamond as a Hedera Token Service account: it associates itself with HTS tokens, moves its own balances, and creates / mints / burns tokens whose supply and admin keys are held by the diamond (as delegatableContractId keys).

Functions

isAssociated

True if the diamond is associated with token (HIP-719 facade isAssociated()).

function isAssociated(address token) external view returns (bool associated);

Parameters

Returns

isHTSToken

True if token is an HTS token (isToken on the system contract).

function isHTSToken(address token) external view returns (bool isToken);

Parameters

Returns

htsTokenType

HTS token type: 0 fungible, 1 non-fungible.

function htsTokenType(address token) external view returns (int32 tokenType);

Parameters

Returns

createdTokens

The HTS tokens this diamond created (it is their treasury and key holder).

function createdTokens() external view returns (address[] memory tokens);

Returns

associateToken

Associates the diamond with token so it can hold and receive it.

function associateToken(address token) external;

Parameters

dissociateToken

Dissociates the diamond from token (its balance must be zero).

function dissociateToken(address token) external;

Parameters

createFungibleToken

Creates a fungible HTS token with the diamond as treasury, auto-renew account, and holder of the admin + supply keys (delegatableContractId). msg.value pays the network's creation fee.

function createFungibleToken(
        string calldata name,
        string calldata symbol,
        string calldata memo,
        int32 decimals,
        int64 initialSupply,
        int64 maxSupply
    ) external payable returns (address token);

Parameters

Returns

createNonFungibleToken

Creates a non-fungible HTS token with the diamond as treasury / key holder. msg.value pays the fee.

function createNonFungibleToken(string calldata name, string calldata symbol, string calldata memo, int64 maxSupply)
        external
        payable
        returns (address token);

Parameters

Returns

transferToken

Transfers amount of token from the diamond's own balance to to.

function transferToken(address token, address to, int64 amount) external;

Parameters

transferTokenFrom

Transfers amount of token from from to to using the allowance from granted the diamond.

function transferTokenFrom(address token, address from, address to, int64 amount) external;

Parameters

transferNFT

Transfers NFT serialNumber of token owned by the diamond to to.

function transferNFT(address token, address to, int64 serialNumber) external;

Parameters

mintToken

Mints amount units (FT) or metadata.length serials (NFT) to the treasury. Requires the diamond to hold the supply key as a delegatableContractId key.

function mintToken(address token, int64 amount, bytes[] calldata metadata)
        external
        returns (int64 newTotalSupply, int64[] memory serialNumbers);

Parameters

Returns

burnToken

Burns amount units (FT) or the given serialNumbers (NFT) from the treasury.

function burnToken(address token, int64 amount, int64[] calldata serialNumbers)
        external
        returns (int64 newTotalSupply);

Parameters

Returns

Events

HTSTokenAssociated

Emitted when the diamond associates itself with token.

event HTSTokenAssociated(address indexed token);

Parameters

HTSTokenDissociated

Emitted when the diamond dissociates itself from token.

event HTSTokenDissociated(address indexed token);

Parameters

HTSTokenCreated

Emitted when the diamond creates an HTS token (it is the treasury and key holder).

event HTSTokenCreated(address indexed token, bool fungible);

Parameters

HTSTokenTransferred

Emitted on a successful HTS transfer initiated by the diamond.

event HTSTokenTransferred(address indexed token, address indexed from, address indexed to, int64 amount);

Parameters

HTSTokenMinted

Emitted after a successful mint (amount is units for FT, number of serials for NFT).

event HTSTokenMinted(address indexed token, int64 amount, int64 newTotalSupply);

Parameters

HTSTokenBurned

Emitted after a successful burn.

event HTSTokenBurned(address indexed token, int64 amount, int64 newTotalSupply);

Parameters

Errors

HTSTokenNotAssociated

account is not associated with token (HTS 184).

error HTSTokenNotAssociated(address token, address account);

Parameters

HTSTokenAlreadyAssociated

account is already associated with token (HTS 194).

error HTSTokenAlreadyAssociated(address token, address account);

Parameters

HTSInsufficientBalance

account holds too little of token (HTS 178 / 28).

error HTSInsufficientBalance(address token, address account);

Parameters

HTSNonZeroBalance

account still holds a balance of token, so it cannot be dissociated (HTS 195).

error HTSNonZeroBalance(address token, address account);

Parameters

HTSAccountIsTreasury

account is token's treasury, so it can never be dissociated from it (HTS 196).

error HTSAccountIsTreasury(address token, address account);

Parameters

HTSKeyNotActive

No active key authorized the operation (HTS 7 / 326). For a diamond the usual cause is a token key set as contractId instead of delegatableContractId: a facet reaches HTS inside a delegatecall frame, where a contractId key is refused wherever it is verified. Note this error is NOT what you get for a contractId(<diamond>) key on a relay-deployed diamond — that key is byte-identical to the diamond's own account key, which is the dispatched child's payer key, so it is elided before verification and the call succeeds. Measured on testnet 2026-09-12; see docs/guides/hedera.md.

error HTSKeyNotActive(address token);

Parameters

HTSTokenNoSupplyKey

token has no supply key (HTS 180).

error HTSTokenNoSupplyKey(address token);

Parameters

HTSMaxSupplyReached

The mint would exceed token's max supply (HTS 236).

error HTSMaxSupplyReached(address token);

Parameters

HTSTokenPaused

token is paused (HTS 265).

error HTSTokenPaused(address token);

Parameters

HTSAccountFrozen

account is frozen for token (HTS 165).

error HTSAccountFrozen(address token, address account);

Parameters

HTSKycNotGranted

account has no KYC grant for token (HTS 176).

error HTSKycNotGranted(address token, address account);

Parameters

HTSAllowanceExceeded

The diamond's allowance from owner on token is missing or too small (HTS 292 / 293).

error HTSAllowanceExceeded(address token, address owner);

Parameters

HTSInsufficientGas

The frame did not carry enough gas for the system-contract fee (HTS 30).

error HTSInsufficientGas();

HTSNotAToken

token is not an HTS token (HTS 167 / isToken false).

error HTSNotAToken(address token);

Parameters

HTSInvalidAmount

An amount, serial list, or supply parameter was invalid (HTS 182 / 183 / 225 or local check).

error HTSInvalidAmount();

HTSCallFailed

Catch-all: HTS function selector returned responseCode.

error HTSCallFailed(bytes4 selector, int64 responseCode);

Parameters