Class Agent

Represents a connection to the Secret Network, authenticated as a specific address.

Hierarchy

Agent
- Agent

Index

Constructors

constructor

new Agent(options?): Agent
Parameters
- options: Partial<Agent> = {}
Returns Agent
Overrides Agent.constructor
- Defined in connect/scrt/scrt-chain.ts:163

Properties

Bundle

Bundle: BundleClass<Bundle> = ScrtAgent.Bundle

Bundle class used by this agent.

`Optional` address

address?: string

The address from which transactions are signed and sent.

chain

chain: Chain

Downcast chain property to Scrt only.

fees

fees: AgentFees = ScrtChain.defaultFees

Default fees for this agent.

log

log: Console = ...

`Optional` mnemonic

mnemonic?: string

The wallet's mnemonic.

`Optional` name

name?: string

The friendly name of the agent.

simulateForGas

simulateForGas: boolean = false

Whether to simulate each execution first to get a more accurate gas estimate.

`Static` Bundle

Bundle: BundleClass<Bundle>

The default Bundle class used by this Agent.

Accessors

[toStringTag]

get [toStringTag](): string
Returns string
Inherited from Agent.[toStringTag]
- Defined in agent/agent-chain.ts:266

account

get account(): Promise<{
account?: Account;
}>
Returns Promise<{
account?: Account;
}>
- Defined in connect/scrt/scrt-chain.ts:264

api

get api(): undefined | SecretNetworkClient
Instance of the underlying platform API provided by secretjs.

Returns undefined | SecretNetworkClient
- Defined in connect/scrt/scrt-chain.ts:241
set api(value): void
Parameters
- value: undefined | SecretNetworkClient
Returns void
- Defined in connect/scrt/scrt-chain.ts:244

balance

get balance(): Promise<string>
This agent's balance in the chain's native token.

Returns Promise<string>
Overrides Agent.balance
- Defined in connect/scrt/scrt-chain.ts:268

defaultDenom

get defaultDenom(): string
The default denomination in which the agent operates.

Returns string
Inherited from Agent.defaultDenom
- Defined in agent/agent-chain.ts:286

encryptionUtils

get encryptionUtils(): undefined | EncryptionUtils
Provide this to allow SecretJS to sign with keys stored in Keplr.

Returns undefined | EncryptionUtils
- Defined in connect/scrt/scrt-chain.ts:257
set encryptionUtils(value): void
Parameters
- value: undefined | EncryptionUtils
Returns void
- Defined in connect/scrt/scrt-chain.ts:260

height

get height(): Promise<number>
The chain's current block height.

Returns Promise<number>
Inherited from Agent.height
- Defined in agent/agent-chain.ts:294

nextBlock

get nextBlock(): Promise<number>
Wait until the block height increments.

Returns Promise<number>
Inherited from Agent.nextBlock
- Defined in agent/agent-chain.ts:298

ready

get ready(): Promise<this & {
api: SecretNetworkClient;
}>
Complete the asynchronous initialization of this Agent.

Returns Promise<this & {
api: SecretNetworkClient;
}>
Overrides Agent.ready
- Defined in connect/scrt/scrt-chain.ts:175

wallet

get wallet(): undefined | Wallet
This agent's identity on the chain.

Returns undefined | Wallet
- Defined in connect/scrt/scrt-chain.ts:249
set wallet(value): void
Parameters
- value: undefined | Wallet
Returns void
- Defined in connect/scrt/scrt-chain.ts:252

Methods

bundle

bundle(cb?): B
Execute a transaction bundle.
Type Parameters
- B extends Bundle
Parameters
- Optional cb: BundleCallback
Returns B
Bundle if called with no arguments
Inherited from Agent.bundle
- Defined in agent/agent-chain.ts:415

checkHash

checkHash(address, codeHash?): Promise<string>
Check the code hash of a contract at an address against an expected value.
Parameters
- address: string
- Optional codeHash: string
Returns Promise<string>
Inherited from Agent.checkHash
- Defined in agent/agent-chain.ts:320

decryptError

decryptError(result): Error & SecretJS.TxResponse
Parameters
- result: SecretJS.TxResponse
Returns Error & SecretJS.TxResponse
- Defined in connect/scrt/scrt-chain.ts:495

encrypt

encrypt(codeHash, msg): Promise<string>
Parameters
- codeHash: string
- msg: Message
Returns Promise<string>
- Defined in connect/scrt/scrt-chain.ts:327

execute

execute(instance, msg, opts?): Promise<SecretJS.TxResponse>
Call a transaction method on a smart contract.
Parameters
- instance: Partial<Client>
- msg: Message
- opts: ExecOpts = {}
Returns Promise<SecretJS.TxResponse>
Overrides Agent.execute
- Defined in connect/scrt/scrt-chain.ts:453

getBalance

getBalance(denom?, address): Promise<string>
Get the balance of this or another address.
Parameters
- denom: string = ...
- address: string
Returns Promise<string>
Overrides Agent.getBalance
- Defined in connect/scrt/scrt-chain.ts:272

getClient

getClient<C>($C, address?, codeHash?, ...args): C
Get a client instance for talking to a specific smart contract as this executor.
Type Parameters
- C extends Client
Parameters
- $C: ClientClass<C>
- Optional address: string
- Optional codeHash: string
- Rest ...args: unknown[]
Returns C
Inherited from Agent.getClient
- Defined in agent/agent-chain.ts:396

getCodeId

getCodeId(contract_address): Promise<string>
Get the code ID of a contract.
Parameters
- contract_address: string
Returns Promise<string>
Overrides Agent.getCodeId
- Defined in connect/scrt/scrt-chain.ts:297

getHash

getHash(arg): Promise<string>
Get the code hash of a contract or template.
Parameters
- arg: string | number
Returns Promise<string>
Overrides Agent.getHash
- Defined in connect/scrt/scrt-chain.ts:303

getLabel

getLabel(contract_address): Promise<string>
Get the label of a contract.
Parameters
- contract_address: string
Returns Promise<string>
Overrides Agent.getLabel
- Defined in connect/scrt/scrt-chain.ts:291

getNonce

getNonce(): Promise<{
accountNumber: number;
sequence: number;
}>
Returns Promise<{
accountNumber: number;
sequence: number;
}>
- Defined in connect/scrt/scrt-chain.ts:316

getUploader

getUploader($U, options?): U
Get an uploader instance which performs code uploads and optionally caches them.
Type Parameters
- U extends Uploader
Parameters
- $U: UploaderClass
- Optional options: Partial
Returns U
Inherited from Agent.getUploader
- Defined in agent/agent-chain.ts:343

instantiate

instantiate<C>(instance, init_funds?): Promise<Instantiated>
Create a new smart contract from a code id, label and init message.
Type Parameters
- C extends Client
Parameters
- instance: Contract<C>
- init_funds: ICoin[] = []
Returns Promise<Instantiated>
AnyContract with no address populated yet. This will be populated after executing the bundle.
Example
```
await agent.instantiate(template.define({ label, initMsg })
```
Overrides Agent.instantiate
- Defined in connect/scrt/scrt-chain.ts:386

instantiateMany

instantiateMany<C>(instances): Promise<C>
Create multiple smart contracts from a Template (providing code id) and a list or map of label/initmsg pairs. Uses this agent's Bundle class to instantiate them in a single transaction.
Type Parameters
- C extends Many<AnyContract>
Parameters
- instances: C
Returns Promise<C>
either an Array or a Record<string, AnyContract>, depending on what is passed as inputs.
Example
```
await agent.instantiateMany(template.instances({
 One: { label, initMsg },
 Two: { label, initMsg },
 }))
 await agent.instantiateMany({
 One: template1.instance({ label, initMsg }),
 Two: template2.instance({ label, initMsg }),
 }))
```
Inherited from Agent.instantiateMany
- Defined in agent/agent-chain.ts:376

query

query(instance, query): Promise
Query a Client.
Type Parameters
- U
Parameters
- instance: Partial<Client>
- query: Message
Returns Promise
the result of the query
Overrides Agent.query
- Defined in connect/scrt/scrt-chain.ts:337

send

send(to, amounts, opts?): Promise<SecretJS.TxResponse>
Send native tokens to 1 recipient.
Parameters
- to: string
- amounts: ICoin[]
- Optional opts: any
Returns Promise<SecretJS.TxResponse>
Overrides Agent.send
- Defined in connect/scrt/scrt-chain.ts:278

sendMany

sendMany(outputs, opts): Promise<void>
Send native tokens to multiple recipients.
Parameters
- outputs: never
- opts: never
Returns Promise<void>
Overrides Agent.sendMany
- Defined in connect/scrt/scrt-chain.ts:287

upload

upload(data): Promise<Uploaded>
Upload a WASM binary.
Parameters
- data: Uint8Array
Returns Promise<Uploaded>
Overrides Agent.upload
- Defined in connect/scrt/scrt-chain.ts:347

Class Agent

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

options: Partial<Agent> = {}

Returns Agent

Properties

Bundle

Optional address

chain

fees

log

Optional mnemonic

Optional name

simulateForGas

Static Bundle

Accessors

[toStringTag]

Returns string

account

Returns Promise<{ account?: Account; }>

api

Returns undefined | SecretNetworkClient

Parameters

value: undefined | SecretNetworkClient

Returns void

balance

Returns Promise<string>

defaultDenom

Returns string

encryptionUtils

Returns undefined | EncryptionUtils

Parameters

value: undefined | EncryptionUtils

Returns void

height

Returns Promise<number>

nextBlock

Returns Promise<number>

ready

Returns Promise<this & { api: SecretNetworkClient; }>

wallet

Returns undefined | Wallet

Parameters

value: undefined | Wallet

Returns void

Methods

bundle

Type Parameters

B extends Bundle

Parameters

Optional cb: BundleCallback<B>

Returns B

checkHash

Parameters

address: string

Optional codeHash: string

Returns Promise<string>

decryptError

Parameters

result: SecretJS.TxResponse

Returns Error & SecretJS.TxResponse

encrypt

Parameters

codeHash: string

msg: Message

Returns Promise<string>

execute

Parameters

instance: Partial<Client>

msg: Message

opts: ExecOpts = {}

Returns Promise<SecretJS.TxResponse>

getBalance

`Optional` address

`Optional` mnemonic

`Optional` name

`Static` Bundle

Returns Promise<{
account?: Account;
}>

Returns Promise<this & {
api: SecretNetworkClient;
}>

`Optional` cb: BundleCallback<B>

`Optional` codeHash: string

`Optional` address: string

`Optional` codeHash: string

`Rest` ...args: unknown[]

Returns Promise<{
accountNumber: number;
sequence: number;
}>

`Optional` options: Partial<U>

`Optional` opts: any