Class Snip20

An abstract fungible token.

Hierarchy

Client
- Snip20

Implements

TokenFungible

Constructors

constructor

new Snip20(options?: Partial<Client>): Scrt.Snip20
Parameters
- options: Partial<Client> = {}
Returns Scrt.Snip20
Inherited from Client.constructor
- Defined in agent/agent-client.ts:51

Properties

`Optional` address

address?: string

Address of the contract on the chain.

`Optional` agent

agent?: Agent

Agent that will interact with the contract.

`Optional` codeHash

codeHash?: string

Code hash confirming the contract's integrity.

decimals

decimals: null | number = null

The decimal precision of the token.

`Optional` fee

fee?: IFee

Default fee for all contract transactions.

fees

fees: Record<string, IFee> = {}

Default fee for specific transactions.

log

log: Scrt.Console = ...

name

name: null | string = null

The full name of the token.

symbol

symbol: null | string = null

The market symbol of the token.

totalSupply

totalSupply: null | string = null

The total supply of the token.

Accessors

asContractCode

get asContractCode(): ContractCode
The contract template represented in factory format ({code_id, code_hash})

Returns ContractCode
Inherited from Client.asContractCode
- Defined in agent/agent-client.ts:68

asContractLink

get asContractLink(): ContractLink
The contract represented in ICC format ({address, code_hash})

Returns ContractLink
Inherited from Client.asContractLink
- Defined in agent/agent-client.ts:64

asDescriptor

get asDescriptor(): CustomToken
Returns
self as plain CustomToken with a hidden (from serialization!) client property pointing to this.

Returns CustomToken
- Defined in connect/scrt/scrt-token.ts:52

chain

get chain(): undefined | Chain
The chain on which this contract exists.

Returns undefined | Chain
Inherited from Client.chain
- Defined in agent/agent-client.ts:60

id

get id(): string
Get a comparable token ID.

Returns string
Implementation of TokenFungible.id
- Defined in connect/scrt/scrt-token.ts:47

vk

get vk(): Scrt.ViewingKeyClient
Get a client to the Viewing Key API.

Returns Scrt.ViewingKeyClient
- Defined in connect/scrt/scrt-token.ts:49

Methods

addMinters

addMinters(minters: string[]): Promise<unknown>
Add addresses to be minters
Parameters
- minters: string[]
Returns Promise<unknown>
- Defined in connect/scrt/scrt-token.ts:91

batchSend

batchSend(actions: Scrt.SendAction[]): Promise<unknown>
Parameters
- actions: Scrt.SendAction[]
Returns Promise<unknown>
- Defined in connect/scrt/scrt-token.ts:156

batchSendFrom

batchSendFrom(actions: Scrt.SendFromAction[]): Promise<unknown>
Parameters
- actions: Scrt.SendFromAction[]
Returns Promise<unknown>
- Defined in connect/scrt/scrt-token.ts:158

batchTransfer

batchTransfer(actions: Scrt.TransferAction[]): Promise<unknown>
Parameters
- actions: Scrt.TransferAction[]
Returns Promise<unknown>
- Defined in connect/scrt/scrt-token.ts:152

batchTransferFrom

batchTransferFrom(actions: Scrt.TransferFromAction[]): Promise<unknown>
Parameters
- actions: Scrt.TransferFromAction[]
Returns Promise<unknown>
- Defined in connect/scrt/scrt-token.ts:154

burn

burn(amount: string | number | bigint, memo?: string): Promise<unknown>
Burn SNIP20 tokens
Parameters
- amount: string | number | bigint
- Optional memo: string
Returns Promise<unknown>
- Defined in connect/scrt/scrt-token.ts:103

changeAdmin

changeAdmin(address: string): Promise<unknown>
Change the admin of the token, who can set the minters
Parameters
- address: string
Returns Promise<unknown>
- Defined in connect/scrt/scrt-token.ts:85

checkAllowance

checkAllowance(spender: string, owner: string, key: string): Promise<unknown>
Check the current allowance from owner to spender.
Parameters
- spender: string
- owner: string
- key: string
Returns Promise<unknown>
- Defined in connect/scrt/scrt-token.ts:118

decreaseAllowance

decreaseAllowance(amount: string | number | bigint, spender: string): Promise<unknown>
Decrease allowance to spender
Parameters
- amount: string | number | bigint
- spender: string
Returns Promise<unknown>
- Defined in connect/scrt/scrt-token.ts:129

deposit

deposit(nativeTokens: ICoin[]): Promise<unknown>
Deposit native tokens into the contract.
Parameters
- nativeTokens: ICoin[]
Returns Promise<unknown>
- Defined in connect/scrt/scrt-token.ts:106

execute

execute(msg: Message, opt?: ExecOpts): Promise<unknown>
Execute a transaction on the specified contract as the specified Agent.
Parameters
- msg: Message
- opt: ExecOpts = {}
Returns Promise<unknown>
Inherited from Client.execute
- Defined in agent/agent-client.ts:83

fetchCodeHash

fetchCodeHash(expected?: undefined | string): Promise<Scrt.Snip20>
Fetch code hash from address.

Returns
Promise
Parameters
- expected: undefined | string = ...
Returns Promise<Scrt.Snip20>
Inherited from Client.fetchCodeHash
- Defined in agent/agent-client.ts:73

fetchMetadata

fetchMetadata(): Promise<Scrt.Snip20>
Returns Promise<Scrt.Snip20>
- Defined in connect/scrt/scrt-token.ts:61

getAllowance

getAllowance(owner: string, spender: string, key: string): Promise<Scrt.Allowance>
Get the current allowance from owner to spender
Parameters
- owner: string
- spender: string
- key: string
Returns Promise<Scrt.Allowance>
- Defined in connect/scrt/scrt-token.ts:112

getBalance

getBalance(address: string, key: string): Promise<string>
Parameters
- address: string
- key: string
Returns Promise<string>
- Defined in connect/scrt/scrt-token.ts:75

getFee

getFee(msg?: string | Record<string, unknown>): undefined | IFee
Get the recommended fee for a specific transaction.
Parameters
- Optional msg: string | Record<string, unknown>
Returns undefined | IFee
Inherited from Client.getFee
- Defined in agent/agent-client.ts:89

getTokenInfo

getTokenInfo(): Promise<Scrt.TokenInfo>
Returns Promise<Scrt.TokenInfo>
- Defined in connect/scrt/scrt-token.ts:70

increaseAllowance

increaseAllowance(amount: string | number | bigint, spender: string): Promise<unknown>
Increase allowance to spender
Parameters
- amount: string | number | bigint
- spender: string
Returns Promise<unknown>
- Defined in connect/scrt/scrt-token.ts:121

isCustom

isCustom(): boolean
Returns
true

Returns boolean
Implementation of TokenFungible.isCustom
- Defined in connect/scrt/scrt-token.ts:57

isFungible

isFungible(): boolean
Returns
true

Returns boolean
Implementation of TokenFungible.isFungible
- Defined in connect/scrt/scrt-token.ts:55

isNative

isNative(): boolean
Returns
false

Returns boolean
Implementation of TokenFungible.isNative
- Defined in connect/scrt/scrt-token.ts:59

mint

mint(amount: string | number | bigint, recipient?: undefined | string): Promise<unknown>
Mint SNIP20 tokens
Parameters
- amount: string | number | bigint
- recipient: undefined | string = ...
Returns Promise<unknown>
- Defined in connect/scrt/scrt-token.ts:94

query

query<U>(msg: Message): Promise<U>
Execute a query on the specified contract as the specified Agent.
Type Parameters
- U
Parameters
- msg: Message
Returns Promise<U>
Inherited from Client.query
- Defined in agent/agent-client.ts:79

redeem

redeem(amount: string | number | bigint, denom?: string): Promise<unknown>
Redeem an amount of a native token from the contract.
Parameters
- amount: string | number | bigint
- Optional denom: string
Returns Promise<unknown>
- Defined in connect/scrt/scrt-token.ts:109

send

send(amount: string | number | bigint, recipient: string, callback?: string | object): Promise<unknown>
Send tokens to address. Same as transfer but allows for receive callback.
Parameters
- amount: string | number | bigint
- recipient: string
- Optional callback: string | object
Returns Promise<unknown>
- Defined in connect/scrt/scrt-token.ts:138

sendFrom

sendFrom(owner: string, amount: string, recipient: String, hash?: string, msg?: string, memo?: string): Promise<unknown>
Parameters
- owner: string
- amount: string
- recipient: String
- Optional hash: string
- Optional msg: string
- Optional memo: string
Returns Promise<unknown>
- Defined in connect/scrt/scrt-token.ts:146

setMinters

setMinters(minters: string[]): Promise<unknown>
Set specific addresses to be minters, remove all others
Parameters
- minters: string[]
Returns Promise<unknown>
- Defined in connect/scrt/scrt-token.ts:88

transfer

transfer(amount: string | number | bigint, recipient: string): Promise<unknown>
Transfer tokens to address
Parameters
- amount: string | number | bigint
- recipient: string
Returns Promise<unknown>
- Defined in connect/scrt/scrt-token.ts:132

transferFrom

transferFrom(owner: string, recipient: string, amount: string, memo?: string): Promise<unknown>
Parameters
- owner: string
- recipient: string
- amount: string
- Optional memo: string
Returns Promise<unknown>
- Defined in connect/scrt/scrt-token.ts:134

`Protected` validate

validate(kind: string, expected: any, actual: any): void
Throw if fetched metadata differs from configured.
Parameters
- kind: string
- expected: any
- actual: any
Returns void
Inherited from Client.validate
- Defined in agent/agent-client.ts:120

withAgent

withAgent(agent?: undefined | Agent): Scrt.Snip20
Returns
a copy of this Client that will execute the transactions as a different Agent.
Parameters
- agent: undefined | Agent = ...
Returns Scrt.Snip20
Inherited from Client.withAgent
- Defined in agent/agent-client.ts:113

withFee

withFee(fee: IFee): Scrt.Snip20
Use the specified fee for all transactions by this Client.
Parameters
- fee: IFee
Returns Scrt.Snip20
Inherited from Client.withFee
- Defined in agent/agent-client.ts:102

withFees

withFees(fees: Record<string, IFee>): Scrt.Snip20
Use the specified fee table for all subsequent transactions by this Client.
Parameters
- fees: Record<string, IFee>
Returns Scrt.Snip20
Inherited from Client.withFees
- Defined in agent/agent-client.ts:108

`Static` fromDescriptor

fromDescriptor(descriptor: CustomToken, agent?: Agent): Scrt.Snip20
Create a SNIP20 token client from a CustomToken descriptor.
Parameters
- descriptor: CustomToken
- Optional agent: Agent
Returns Scrt.Snip20
- Defined in connect/scrt/scrt-token.ts:29

`Static` init

init(name: string, symbol: string, decimals: number, admin: string | {
    address: string;
}, config?: Partial<Scrt.Snip20InitConfig>, balances?: {
    address: string;
    amount: string;
}[]): Scrt.Snip20InitMsg
Create a SNIP20 init message.
Parameters
- name: string
- symbol: string
- decimals: number
- admin: string | {
  address: string;
  }
- config: Partial<Scrt.Snip20InitConfig> = {}
- balances: {
  address: string;
  amount: string;
  }[] = []
Returns Scrt.Snip20InitMsg
- Defined in connect/scrt/scrt-token.ts:32

Class Snip20

Hierarchy

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

options: Partial<Client> = {}

Returns Scrt.Snip20

Properties

Optional address

Optional agent

Optional codeHash

decimals

Optional fee

fees

log

meta

name

symbol

totalSupply

Accessors

asContractCode

Returns ContractCode

asContractLink

Returns ContractLink

asDescriptor

Returns

Returns CustomToken

chain

Returns undefined | Chain

id

Returns string

vk

Returns Scrt.ViewingKeyClient

Methods

addMinters

Parameters

minters: string[]

Returns Promise<unknown>

batchSend

Parameters

actions: Scrt.SendAction[]

Returns Promise<unknown>

batchSendFrom

Parameters

actions: Scrt.SendFromAction[]

Returns Promise<unknown>

batchTransfer

Parameters

actions: Scrt.TransferAction[]

Returns Promise<unknown>

batchTransferFrom

Parameters

actions: Scrt.TransferFromAction[]

Returns Promise<unknown>

burn

Parameters

amount: string | number | bigint

Optional memo: string

Returns Promise<unknown>

changeAdmin

Parameters

address: string

Returns Promise<unknown>

checkAllowance

Parameters

spender: string

owner: string

key: string

Returns Promise<unknown>

decreaseAllowance

Parameters

amount: string | number | bigint

spender: string

Returns Promise<unknown>

`Optional` address

`Optional` agent

`Optional` codeHash

`Optional` fee

`Optional` memo: string

`Optional` msg: string | Record<string, unknown>

`Optional` denom: string

`Optional` callback: string | object