opnet/src/abi/shared/interfaces/opnet/IOP_20Contract.ts

The perfect library for building Bitcoin-based applications.

import { Address, AddressMap } from '@btc-vision/transaction';
import { CallResult } from '../../../../contracts/CallResult.js';
import { OPNetEvent } from '../../../../contracts/OPNetEvent.js';
import { IOP_NETContract } from './IOP_NETContract.js';

export type MintEvent = {
    to: Address;
    amount: bigint;
};

export type TransferEvent = {
    from: Address;
    to: Address;
    amount: bigint;
};

export type BurnEvent = {
    amount: bigint;
};

export type ApproveEvent = {
    owner: Address;
    spender: Address;
    value: bigint;
};

export type Name = CallResult<{ name: string }, []>;
export type BalanceOf = CallResult<{ balance: bigint }, []>;
export type SymbolOf = CallResult<{ symbol: string }, []>;
export type TotalSupply = CallResult<{ totalSupply: bigint }, []>;
export type MaxSupply = CallResult<{ maximumSupply: bigint }, []>;
export type Decimals = CallResult<{ decimals: number }, []>;

export type Transfer = CallResult<
    {
        success: boolean;
    },
    [OPNetEvent<TransferEvent>]
>;

export type TransferFrom = CallResult<{ success: boolean }, [OPNetEvent<TransferEvent>]>;
export type Approve = CallResult<{ success: boolean }, [OPNetEvent<ApproveEvent>]>;
export type Allowance = CallResult<{ remaining: bigint }, []>;
export type Burn = CallResult<{ success: boolean }, [OPNetEvent<BurnEvent>]>;
export type Mint = CallResult<{ success: boolean }, [OPNetEvent<MintEvent>]>;
export type Airdrop = CallResult<{ success: boolean }, OPNetEvent<MintEvent>[]>;
export type AirdropWithAmount = CallResult<{ success: boolean }, OPNetEvent<MintEvent>[]>;

/**
 * @description This interface represents the OP_20 base contract.
 * @interface IOP_20Contract
 * @extends {IOP_NETContract}
 * @cathegory Contracts
 *
 * @example
 * import { Address } from '@btc-vision/transaction';
 * import { IOP_20Contract } from '../abi/shared/interfaces/IOP_20Contract.js';
 * import { OP_20_ABI } from '../abi/shared/json/OP_20_ABI.js';
 * import { CallResult } from '../contracts/CallResult.js';
 * import { getContract } from '../contracts/Contract.js';
 * import { JSONRpcProvider } from '../providers/JSONRpcProvider.js';
 *
 * const provider: JSONRpcProvider = new JSONRpcProvider('https://regtest.opnet.org');
 * const contract: IOP_20Contract = getContract<IOP_20Contract>(
 *     'bcrt1pyrs3eqwnrmd4ql3nwvx66yzp0wc24xd2t9pf8699ln340pjs7f3sar3tum',
 *     OP_20_ABI,
 *     provider,
 *     networks.regtest,
 * );
 *
 * const address: Address = new Address([
 *    40, 11, 228, 172, 219, 50, 169, 155, 163, 235, 250, 102, 169, 29, 219, 65, 167, 183, 161, 210,
 *    254, 244, 21, 57, 153, 34, 205, 138, 4, 72, 92, 2,
 * ]);
 *
 * const balanceExample = await contract.balanceOf(
 *     address
 * );
 *
 * console.log('Balance:', balanceExample.properties.balance);
 */
export interface IOP_20Contract extends IOP_NETContract {
    balanceOf(account: Address): Promise<BalanceOf>;

    name(): Promise<Name>;

    symbol(): Promise<SymbolOf>;

    totalSupply(): Promise<TotalSupply>;

    maximumSupply(): Promise<MaxSupply>;

    decimals(): Promise<Decimals>;

    transfer(recipient: Address, amount: bigint): Promise<Transfer>;

    transferFrom(sender: Address, recipient: Address, amount: bigint): Promise<TransferFrom>;

    approve(spender: Address, amount: bigint): Promise<Approve>;

    approveFrom(spender: Address, amount: bigint, signature: Uint8Array): Promise<Approve>;

    allowance(owner: Address, spender: Address): Promise<Allowance>;

    burn(value: bigint): Promise<Burn>;

    mint(address: Address, value: bigint): Promise<Mint>;

    airdrop(map: AddressMap<bigint>): Promise<Airdrop>;

    airdropWithAmount(amount: bigint, addresses: Address[]): Promise<AirdropWithAmount>;
}