@spec append_file(t(), Hedera.FileId.t(), binary(), keyword()) ::
  {:ok, result()} | {:error, term()}

Append contents to file (needs the file's key).

@spec approve_allowance(
  t(),
  keyword()
) :: {:ok, result()} | {:error, term()}

Approve allowances so a spender can move the owner's assets without the owner's key. See Hedera.Transaction.approve_allowance/1 (:hbar_allowances, :token_allowances, :nft_allowances). Owners other than the operator must sign — pass their keys via signers: in opts.

@spec associate_token(t(), Hedera.AccountId.t(), [Hedera.TokenId.t()], keyword()) ::
  {:ok, result()} | {:error, term()}

Associate tokens with account. The account must sign; when it is not the operator, pass its key via signers: [account_key] in opts.

@spec burn_token(t(), Hedera.TokenId.t(), non_neg_integer(), keyword()) ::
  {:ok, result()} | {:error, term()}

Burn amount of a token from the treasury. Needs the supply key.

@spec call_contract(t(), Hedera.ContractId.t(), keyword()) ::
  {:ok, result()} | {:error, term()}

Call a contract method. Opts: :gas, :amount, :function_parameters (ABI-encoded). The return value is in the record, not the receipt.

@spec create_account(
  t(),
  keyword()
) :: {:ok, result()} | {:error, term()}

Create a new account. See Hedera.Transaction.crypto_create/1 for opts (:key, :initial_balance, …). The new account's id is in the receipt's account_id.

@spec create_contract(
  t(),
  keyword()
) :: {:ok, result()} | {:error, term()}

Deploy a smart contract. See Hedera.Transaction.contract_create/1 for opts (:bytecode or :file, plus :gas etc.). New contract id is in the receipt.

@spec create_file(
  t(),
  keyword()
) :: {:ok, result()} | {:error, term()}

Create a file. See Hedera.Transaction.file_create/1 for opts. New file id is in the receipt.

@spec create_schedule(
  t(),
  keyword()
) :: {:ok, result()} | {:error, term()}

Create a scheduled transfer. See Hedera.Transaction.schedule_create/1. Schedule id is in the receipt.

@spec create_token(
  t(),
  keyword()
) :: {:ok, result()} | {:error, term()}

Create a new HTS token. See Hedera.Transaction.token_create/1 for opts (:treasury is required). The new token's id is in the receipt's token_id.

@spec create_topic(
  t(),
  keyword()
) :: {:ok, result()} | {:error, term()}

Create a new HCS topic (open, unless :memo given).

@spec delete_account(t(), Hedera.AccountId.t(), keyword()) ::
  {:ok, result()} | {:error, term()}

Delete account, sweeping its remaining hbar to :transfer_account (defaults to the operator). The account's key must sign — pass via signers: when it is not the operator.

@spec delete_file(t(), Hedera.FileId.t(), keyword()) ::
  {:ok, result()} | {:error, term()}

Delete file (needs the file's key).

@spec delete_nft_allowance(
  t(),
  keyword()
) :: {:ok, result()} | {:error, term()}

Delete NFT-serial allowances. See Hedera.Transaction.delete_nft_allowance/1 (:nft_allowances).

@spec delete_token(t(), Hedera.TokenId.t(), keyword()) ::
  {:ok, result()} | {:error, term()}

Delete token (needs the admin key).

@spec dissociate_token(t(), Hedera.AccountId.t(), [Hedera.TokenId.t()], keyword()) ::
  {:ok, result()} | {:error, term()}

Dissociate tokens from account. The account must sign; when it is not the operator, pass its key via signers: [account_key] in opts.

@spec freeze_token(t(), Hedera.TokenId.t(), Hedera.AccountId.t(), keyword()) ::
  {:ok, result()} | {:error, term()}

Freeze token for account (needs the freeze key).

@spec grant_kyc(t(), Hedera.TokenId.t(), Hedera.AccountId.t(), keyword()) ::
  {:ok, result()} | {:error, term()}

Grant KYC of token to account (needs the KYC key).

@spec mint_token(t(), Hedera.TokenId.t(), non_neg_integer(), keyword()) ::
  {:ok, result()} | {:error, term()}

Mint amount of (or :metadata for) a token. Needs the supply key.

@spec pause_token(t(), Hedera.TokenId.t(), keyword()) ::
  {:ok, result()} | {:error, term()}

Pause token (needs the pause key).

@spec revoke_kyc(t(), Hedera.TokenId.t(), Hedera.AccountId.t(), keyword()) ::
  {:ok, result()} | {:error, term()}

Revoke KYC of token from account (needs the KYC key).

@spec sign_schedule(t(), Hedera.ScheduleId.t(), keyword()) ::
  {:ok, result()} | {:error, term()}

Add the operator's (and any :signers') signature to a pending schedule.

@spec submit_message(t(), Hedera.TopicId.t(), binary()) ::
  {:ok, result()} | {:error, term()}

Submit a message to an HCS topic (retries across nodes on transient errors).

@spec testnet(Hedera.AccountId.t(), Hedera.PrivateKey.t()) :: t()

Build a testnet client (with the full testnet node address book).

@spec transaction_receipt(t(), Hedera.TransactionId.t(), keyword()) ::
  {:ok, Hedera.Receipt.t()} | {:error, term()}

Fetch a transaction's consensus receipt, polling until final (free query).

@spec transfer_hbar(t(), [{Hedera.AccountId.t(), integer()}], keyword()) ::
  {:ok, result()} | {:error, term()}

Transfer HBAR between accounts (retries across nodes on transient errors).

transfers is a list of {%AccountId{}, amount_in_tinybars} pairs; debits are negative, credits positive, and they must net to zero.

Hedera.Client.transfer_hbar(client, [{from, -1}, {to, 1}])

@spec transfer_nft(
  t(),
  Hedera.TokenId.t(),
  [{Hedera.AccountId.t(), Hedera.AccountId.t(), integer()}],
  keyword()
) :: {:ok, result()} | {:error, term()}

Transfer NFTs of token. moves is a list of {sender, receiver, serial} tuples (AccountIds + integer serial). Needs sender authorization.

@spec transfer_token(
  t(),
  Hedera.TokenId.t(),
  [{Hedera.AccountId.t(), integer()}],
  keyword()
) ::
  {:ok, result()} | {:error, term()}

Transfer an HTS token between accounts. moves is a list of {%AccountId{}, amount} pairs that must net to zero (debits negative).

@spec unfreeze_token(t(), Hedera.TokenId.t(), Hedera.AccountId.t(), keyword()) ::
  {:ok, result()} | {:error, term()}

Unfreeze token for account (needs the freeze key).

@spec unpause_token(t(), Hedera.TokenId.t(), keyword()) ::
  {:ok, result()} | {:error, term()}

Unpause token (needs the pause key).

@spec update_account(t(), Hedera.AccountId.t(), keyword()) ::
  {:ok, result()} | {:error, term()}

Update account (only the fields you pass change). See Hedera.Transaction.crypto_update/1. The account's current key must sign; a new :key must sign too — pass extra keys via signers: in opts.

@spec update_file(t(), Hedera.FileId.t(), keyword()) ::
  {:ok, result()} | {:error, term()}

Update file (opts: :contents, :keys, :expiration_seconds). Needs the file's key.

@spec update_token(t(), Hedera.TokenId.t(), keyword()) ::
  {:ok, result()} | {:error, term()}

Update token (needs the admin key). See Hedera.Transaction.token_update/1 for opts.

@spec wipe_token(t(), Hedera.TokenId.t(), Hedera.AccountId.t(), keyword()) ::
  {:ok, result()} | {:error, term()}

Wipe a token balance from account (needs the wipe key). Pass amount: for a fungible token or serials: (a list) for NFTs in opts.