Class Connection

Chain instance containing a local mocknet.

Hierarchy (view full)

StubConnection
- Connection

Constructors

constructor

new Connection(options?): Mocknet.Connection
Parameters
- options: Partial<Mocknet.Connection> = {}
Returns Mocknet.Connection
Overrides StubConnection.constructor
- Defined in scrt/scrt-mocknet.ts:26

Properties

alive

alive: boolean = true

Setting this to false stops retries.

`Optional` api

api?: unknown

Platform SDK.

backend

backend: Mocknet.Backend

blockInterval

blockInterval: number = 250

Time to ping for next block.

`Optional` chainId

chainId?: string

Chain ID.

`Optional` fees

fees?: {
    exec?: IFee;
    init?: IFee;
    send?: IFee;
    upload?: IFee;
}

Default transaction fees.

Type declaration

Optional exec?: IFee
Optional init?: IFee
Optional send?: IFee
Optional upload?: IFee

`Optional` identity

identity?: Chain.Identity

Signer identity.

log

log: Core.Console

`Optional` url

url?: string

Connection URL.

`Static` gasToken

gasToken: Native = ...

Native token of chain.

Accessors

[toStringTag]

get [toStringTag](): string
Returns string
Inherited from Stub.StubConnection.[toStringTag]
- Defined in agent/chain.ts:113

address

get address(): string
Returns string
Inherited from Stub.StubConnection.address
- Defined in agent/chain.ts:124

balance

get balance(): Promise<unknown>
Returns Promise<unknown>
Inherited from Stub.StubConnection.balance
- Defined in agent/chain.ts:296

defaultDenom

get defaultDenom(): string
Returns string
Inherited from Stub.StubConnection.defaultDenom
- Defined in agent/chain.ts:128

height

get height(): Promise<number>
Returns Promise<number>
Overrides Stub.StubConnection.height
- Defined in scrt/scrt-mocknet.ts:30

nextBlock

get nextBlock(): Promise<number>
Wait for the block height to increment.

Returns Promise<number>
Overrides Stub.StubConnection.nextBlock
- Defined in scrt/scrt-mocknet.ts:33

Methods

batch

batch(): Chain.Batch<Mocknet.Connection>
Construct a transaction batch.

Returns Chain.Batch<Mocknet.Connection>
Inherited from StubConnection.batch
- Defined in agent/stub.ts:23

doExecute

doExecute(...args): Promise<unknown>
Parameters
- Rest ...args: [contract: {
      address: string;
      codeHash: string;
  }, message: Message, options?: {
      execFee?: IFee;
      execMemo?: string;
      execSend?: ICoin[];
  }]
Returns Promise<unknown>
Overrides StubConnection.doExecute
- Defined in scrt/scrt-mocknet.ts:45

doGetBalance

doGetBalance(token?, address?): Promise<string>
Parameters
- Optional token: string
- Optional address: string
Returns Promise<string>
Inherited from StubConnection.doGetBalance
- Defined in agent/stub.ts:39

doGetBlockInfo

doGetBlockInfo(): Promise<{
height: number;
}>
Returns Promise<{
height: number;
}>
Inherited from StubConnection.doGetBlockInfo
- Defined in agent/stub.ts:29

doGetCodeHashOfAddress

doGetCodeHashOfAddress(address): Promise<string>
Parameters
- address: string
Returns Promise<string>
Inherited from StubConnection.doGetCodeHashOfAddress
- Defined in agent/stub.ts:56

doGetCodeHashOfCodeId

doGetCodeHashOfCodeId(id): Promise<string>
Parameters
- id: string
Returns Promise<string>
Inherited from StubConnection.doGetCodeHashOfCodeId
- Defined in agent/stub.ts:60

doGetCodeId

doGetCodeId(address): Promise<string>
Parameters
- address: string
Returns Promise<string>
Inherited from StubConnection.doGetCodeId
- Defined in agent/stub.ts:45

doGetCodes

doGetCodes(): Promise<{
[k: string]: T;
}>
Returns Promise<{
[k: string]: T;
}>
Inherited from StubConnection.doGetCodes
- Defined in agent/stub.ts:32

doGetContractsByCodeId

doGetContractsByCodeId(id): Promise<{
address: string;
}[]>
Parameters
- id: string
Returns Promise<{
address: string;
}[]>
Inherited from StubConnection.doGetContractsByCodeId
- Defined in agent/stub.ts:52

doGetHeight

doGetHeight(): Promise<number>
Returns Promise<number>
Inherited from StubConnection.doGetHeight
- Defined in agent/stub.ts:26

doInstantiate

doInstantiate(...args): Promise<ContractInstance & {
address: string;
}>
Parameters
- Rest ...args: [codeId: string, options: Partial<ContractInstance>]
Returns Promise<ContractInstance & {
address: string;
}>
Overrides StubConnection.doInstantiate
- Defined in scrt/scrt-mocknet.ts:40

doQuery

doQuery<Q>(contract, message): Promise<Q>
Type Parameters
- Q
Parameters
- contract: string | {
  address: string;
  }
- message: Message
Returns Promise<Q>
Overrides StubConnection.doQuery
- Defined in scrt/scrt-mocknet.ts:48

doSend

doSend(recipient, sums, opts?): Promise<void>
Parameters
- recipient: string
- sums: ICoin[]
- Optional opts: never
Returns Promise<void>
Inherited from StubConnection.doSend
- Defined in agent/stub.ts:70

doSendMany

doSendMany(outputs, opts?): Promise<void>
Parameters
- outputs: [string, ICoin[]][]
- Optional opts: never
Returns Promise<void>
Inherited from StubConnection.doSendMany
- Defined in agent/stub.ts:97

doUpload

doUpload(codeData): Promise<UploadedCode>
Parameters
- codeData: Uint8Array
Returns Promise<UploadedCode>
Inherited from StubConnection.doUpload
- Defined in agent/stub.ts:100

execute

execute(contract, message, options?): Promise<unknown>
Call a given program's transaction method.
Parameters
- contract: string | Partial<ContractInstance>
- message: Message
- Optional options: {
      execFee?: IFee;
      execMemo?: string;
      execSend?: ICoin[];
  }
  - Optional execFee?: IFee
  - Optional execMemo?: string
  - Optional execSend?: ICoin[]
Returns Promise<unknown>
Inherited from StubConnection.execute
- Defined in agent/chain.ts:507

getApi

getApi(): Promise<{}>
Returns Promise<{}>
- Defined in scrt/scrt-mocknet.ts:37

getBalanceIn

getBalanceIn(token, address?): Promise<unknown>
Get the balance in a given native token, of either this connection's identity's address, or of another given address.
Parameters
- token: string
- Optional address: string | {
  address: string;
  }
Returns Promise<unknown>
Inherited from StubConnection.getBalanceIn
- Defined in agent/chain.ts:334

getBalanceOf

getBalanceOf(address, token?): Promise<unknown>
Get the balance in a native token of a given address, either in this connection's gas token, or in another given token.
Parameters
- address: string | {
  address: string;
  }
- Optional token: string
Returns Promise<unknown>
Inherited from StubConnection.getBalanceOf
- Defined in agent/chain.ts:309

getCodeHashOfAddress

getCodeHashOfAddress(contract): Promise<string>
Get the code hash of a given address.
Parameters
- contract: string | {
  address: string;
  }
Returns Promise<string>
Inherited from StubConnection.getCodeHashOfAddress
- Defined in agent/chain.ts:211

getCodeHashOfCodeId

getCodeHashOfCodeId(contract): Promise<string>
Get the code hash of a given code id.
Parameters
- contract: string | {
  codeId: string;
  }
Returns Promise<string>
Inherited from StubConnection.getCodeHashOfCodeId
- Defined in agent/chain.ts:195

getCodeId

getCodeId(contract): Promise<string>
Get the code id of a given address.
Parameters
- contract: string | {
  address: string;
  }
Returns Promise<string>
Inherited from StubConnection.getCodeId
- Defined in agent/chain.ts:179

getCodes

getCodes(): Promise<Record<string, UploadedCode>>
Returns Promise<Record<string, UploadedCode>>
Inherited from StubConnection.getCodes
- Defined in agent/chain.ts:241

getContract

getContract(options): Chain.Contract
Get a client handle for a specific smart contract, authenticated as as this agent.
Parameters
- options: string | {
  address: string;
  }
Returns Chain.Contract
Inherited from StubConnection.getContract
- Defined in agent/chain.ts:227

getContractsByCodeId

getContractsByCodeId(id): Promise<Record<string, Chain.Contract>>
Get client handles for all contracts that match a code ID
Parameters
- id: string
Returns Promise<Record<string, Chain.Contract>>
Inherited from StubConnection.getContractsByCodeId
- Defined in agent/chain.ts:249
getContractsByCodeId<C>(id, $C): Promise<Record<string, InstanceType<C>>>
Type Parameters
- C extends typeof Chain.Contract
Parameters
- id: string
- $C: C
Returns Promise<Record<string, InstanceType<C>>>
Inherited from StubConnection.getContractsByCodeId
- Defined in agent/chain.ts:251

getContractsByCodeIds

getContractsByCodeIds(ids): Promise<Record<string, Record<string, Chain.Contract>>>
Get client handles for all contracts that match multiple code IDs
Parameters
- ids: Iterable<string>
Returns Promise<Record<string, Record<string, Chain.Contract>>>
Inherited from StubConnection.getContractsByCodeIds
- Defined in agent/chain.ts:271
getContractsByCodeIds<C>(ids, $C?): Promise<Record<string, Record<string, InstanceType<C>>>>
Type Parameters
- C extends typeof Chain.Contract
Parameters
- ids: Iterable<string>
- Optional $C: C
Returns Promise<Record<string, Record<string, InstanceType<C>>>>
Inherited from StubConnection.getContractsByCodeIds
- Defined in agent/chain.ts:273
getContractsByCodeIds<C>(ids): Promise<Record<string, Record<string, InstanceType<C>>>>
Type Parameters
- C extends typeof Chain.Contract
Parameters
- ids: Record<string, C>
Returns Promise<Record<string, Record<string, InstanceType<C>>>>
Inherited from StubConnection.getContractsByCodeIds
- Defined in agent/chain.ts:275

instantiate

instantiate(contract, options): Promise<ContractInstance & {
address: string;
}>
Instantiate a new program from a code id, label and init message.
Parameters
- contract: string | Partial<UploadedCode>
- options: Partial<ContractInstance>
Returns Promise<ContractInstance & {
address: string;
}>
Deploy.ContractInstance with no address populated yet. This will be populated after executing the batch.
Example
```
await agent.instantiate(template.define({ label, initMsg })
```
Inherited from StubConnection.instantiate
- Defined in agent/chain.ts:463

query

query<Q>(contract, message): Promise<Q>
Query a contract.
Type Parameters
- Q
Parameters
- contract: string | {
  address: string;
  }
- message: Message
Returns Promise<Q>
Inherited from StubConnection.query
- Defined in agent/chain.ts:361

send

send(recipient, amounts, options?): Promise<unknown>
Send native tokens to 1 recipient.
Parameters
- recipient: string | {
  address?: string;
  }
- amounts: (ICoin | Amount)[]
- Optional options: {
  sendFee?: IFee;
  sendMemo?: string;
  }
  - Optional sendFee?: IFee
  - Optional sendMemo?: string
Returns Promise<unknown>
Inherited from StubConnection.send
- Defined in agent/chain.ts:377

upload

upload(code, options?): Promise<UploadedCode & {
chainId: string;
codeId: string;
}>
Upload a contract's code, generating a new code id/hash pair.
Parameters
- code: string | Uint8Array | URL | Partial<CompiledCode>
- options: {
      reupload?: boolean;
      uploadFee?: ICoin[] | "auto";
      uploadMemo?: string;
      uploadStore?: UploadStore;
  } = {}
  - Optional reupload?: boolean
  - Optional uploadFee?: ICoin[] | "auto"
  - Optional uploadMemo?: string
  - Optional uploadStore?: UploadStore
Returns Promise<UploadedCode & {
chainId: string;
codeId: string;
}>
Inherited from StubConnection.upload
- Defined in agent/chain.ts:409

`Static` gas

gas(amount): Amount
Native token of chain.
Parameters
- amount: string | number
Returns Amount
Inherited from StubConnection.gas
- Defined in agent/chain.ts:86

Class Connection

Hierarchy (view full)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

options: Partial<Mocknet.Connection> = {}

Returns Mocknet.Connection

Properties

alive

Optional api

backend

blockInterval

Optional chainId

Optional fees

Type declaration

Optional exec?: IFee

Optional init?: IFee

Optional send?: IFee

Optional upload?: IFee

Optional identity

log

Optional url

Static gasToken

Accessors

[toStringTag]

Returns string

address

Returns string

balance

Returns Promise<unknown>

defaultDenom

Returns string

height

Returns Promise<number>

nextBlock

Returns Promise<number>

Methods

batch

Returns Chain.Batch<Mocknet.Connection>

doExecute

Parameters

Rest ...args: [contract: { address: string; codeHash: string; }, message: Message, options?: { execFee?: IFee; execMemo?: string; execSend?: ICoin[]; }]

Returns Promise<unknown>

doGetBalance

Parameters

Optional token: string

Optional address: string

Returns Promise<string>

doGetBlockInfo

Returns Promise<{ height: number; }>

doGetCodeHashOfAddress

Parameters

address: string

Returns Promise<string>

doGetCodeHashOfCodeId

Parameters

id: string

Returns Promise<string>

doGetCodeId

Parameters

address: string

Returns Promise<string>

doGetCodes

Returns Promise<{ [k: string]: T; }>

doGetContractsByCodeId

Parameters

id: string

Returns Promise<{ address: string; }[]>

doGetHeight

Returns Promise<number>

doInstantiate

Parameters

Rest ...args: [codeId: string, options: Partial<ContractInstance>]

Returns Promise<ContractInstance & { address: string; }>

doQuery

`Optional` api

`Optional` chainId

`Optional` fees

`Optional` exec?: IFee

`Optional` init?: IFee

`Optional` send?: IFee

`Optional` upload?: IFee

`Optional` identity

`Optional` url

`Static` gasToken

`Rest` ...args: [contract: {
address: string;
codeHash: string;
}, message: Message, options?: {
execFee?: IFee;
execMemo?: string;
execSend?: ICoin[];
}]

`Optional` token: string

`Optional` address: string

Returns Promise<{
height: number;
}>

Returns Promise<{
[k: string]: T;
}>

Returns Promise<{
address: string;
}[]>

`Rest` ...args: [codeId: string, options: Partial<ContractInstance>]

Returns Promise<ContractInstance & {
address: string;
}>

contract: string | {
address: string;
}

`Optional` opts: never

`Optional` opts: never

`Optional` options: {
execFee?: IFee;
execMemo?: string;
execSend?: ICoin[];
}

`Optional` execFee?: IFee

`Optional` execMemo?: string

`Optional` execSend?: ICoin[]

`Optional` address: string | {
address: string;
}

address: string | {
address: string;
}

`Optional` token: string

contract: string | {
address: string;
}

contract: string | {
codeId: string;
}

contract: string | {
address: string;
}

options: string | {
address: string;
}