Runtime | @algo-builder/runtime

Hierarchy

Runtime

Constructors

constructor

new Runtime(accounts: AccountStoreI[]): Runtime

- Defined in packages/runtime/src/runtime.ts:57
Parameters
- accounts: AccountStoreI[]
Returns Runtime

Properties

ctx

ctx: Context

loadedAssetsDefs

loadedAssetsDefs: Record<string, { clawback?: string; decimals: number | bigint; defaultFrozen?: boolean; freeze?: string; manager?: string; metadataHash?: string | Uint8Array | Buffer; name?: string; note?: string; noteb64?: string; optInAccNames?: string[]; reserve?: string; total: string | number | bigint; unitName?: string; url?: string }>

Optional parentCtx

parentCtx?: Context

Accessors

defaultBalance

get defaultBalance(): number

- Defined in packages/runtime/src/runtime.ts:85
Returns number

Methods

_setupDefaultAccounts

_setupDefaultAccounts(): AccountStore[]

- Defined in packages/runtime/src/runtime.ts:94
Returns a list of initialized default accounts created using static accountSDK from account.ts and funded with default balance (100 ALGO)

Returns AccountStore[]
list of AccountStore

addASADef

addASADef(asa: string, asaDef: { clawback?: string; decimals: number | bigint; defaultFrozen?: boolean; freeze?: string; manager?: string; metadataHash?: string | Uint8Array | Buffer; name?: string; note?: string; noteb64?: string; optInAccNames?: string[]; reserve?: string; total: string | number | bigint; unitName?: string; url?: string }, flags: ASADeploymentFlags): ASAInfo

- Defined in packages/runtime/src/runtime.ts:498
Create Asset in Runtime without using asa.yaml

deprecated
deployASADef should be used instead

Parameters
- asa: string
  
  ASA name
- asaDef: { clawback?: string; decimals: number | bigint; defaultFrozen?: boolean; freeze?: string; manager?: string; metadataHash?: string | Uint8Array | Buffer; name?: string; note?: string; noteb64?: string; optInAccNames?: string[]; reserve?: string; total: string | number | bigint; unitName?: string; url?: string }
  - Optional clawback?: string
  - decimals: number | bigint
  - Optional defaultFrozen?: boolean
  - Optional freeze?: string
  - Optional manager?: string
  - Optional metadataHash?: string | Uint8Array | Buffer
  - Optional name?: string
  - Optional note?: string
  - Optional noteb64?: string
  - Optional optInAccNames?: string[]
  - Optional reserve?: string
  - total: string | number | bigint
  - Optional unitName?: string
  - Optional url?: string
- flags: ASADeploymentFlags
  
  ASA Deployment Flags
Returns ASAInfo

addApp

addApp(approvalProgram: string, clearProgram: string, flags: AppDeploymentFlags, payFlags: TxParams, debugStack?: number): AppInfo

- Defined in packages/runtime/src/runtime.ts:603
create new application and returns application id

deprecated
deployApp should be used instead.

Parameters
- approvalProgram: string
  
  application approval program
- clearProgram: string
  
  application clear program
- flags: AppDeploymentFlags
  
  SSCDeployment flags
- payFlags: TxParams
  
  Transaction parameters
- Optional debugStack: number
Returns AppInfo

addAsset

addAsset(asa: string, flags: ASADeploymentFlags): ASAInfo

- Defined in packages/runtime/src/runtime.ts:475
Create Asset in Runtime using asa.yaml

deprecated
deployASA should be used instead

Parameters
- asa: string
  
  ASA name
- flags: ASADeploymentFlags
  
  ASA Deployment Flags
Returns ASAInfo

addCtxAppCreateTxn

addCtxAppCreateTxn(creator: default, appDef: AppDefinition, payFlags: TxParams): void

- Defined in packages/runtime/src/runtime.ts:563
Parameters
- creator: default
- appDef: AppDefinition
- payFlags: TxParams
Returns void

addCtxAppUpdateTx

addCtxAppUpdateTx(senderAddr: string, appID: number, payFlags: TxParams, flags: AppOptionalFlags): void

- Defined in packages/runtime/src/runtime.ts:687
Parameters
- senderAddr: string
- appID: number
- payFlags: TxParams
- flags: AppOptionalFlags
Returns void

addCtxOptInTx

addCtxOptInTx(senderAddr: string, appID: number, payFlags: TxParams, flags: AppOptionalFlags): void

- Defined in packages/runtime/src/runtime.ts:637
Parameters
- senderAddr: string
- appID: number
- payFlags: TxParams
- flags: AppOptionalFlags
Returns void

assertAccountDefined

assertAccountDefined(address: string, a?: AccountStoreI, line?: number): AccountStoreI

- Defined in packages/runtime/src/runtime.ts:134
asserts if account is defined.

Parameters
- address: string
  
  address
- Optional a: AccountStoreI
  
  account
- Optional line: number
  
  line number in TEAL file Note: if user is accessing this function directly through runtime, the line number is unknown
Returns AccountStoreI

assertAddressDefined

assertAddressDefined(addr: undefined | string, line?: number): string

- Defined in packages/runtime/src/runtime.ts:158
asserts if account address is defined

Parameters
- addr: undefined | string
  
  account address
- Optional line: number
  
  line number in TEAL file Note: if user is accessing this function directly through runtime, the line number is unknown
Returns string

assertAppDefined

assertAppDefined(appID: number, app?: SSCAttributesM, line?: number): SSCAttributesM

- Defined in packages/runtime/src/runtime.ts:177
asserts if application exists in state

Parameters
- appID: number
  
  application index
- Optional app: SSCAttributesM
  
  application
- Optional line: number
  
  line number in TEAL file Note: if user is accessing this function directly through runtime, the line number is unknown
Returns SSCAttributesM

assertAssetDefined

assertAssetDefined(assetId: number, assetDef?: AssetParams, line?: number): AssetParams

- Defined in packages/runtime/src/runtime.ts:196
asserts if asset exists in state

Parameters
- assetId: number
  
  asset index
- Optional assetDef: AssetParams
  
  asset definitions
- Optional line: number
  
  line number Note: if user is accessing this function directly through runtime, the line number is unknown
Returns AssetParams

assertMinBalance

assertMinBalance(amt: bigint, address: string): void

- Defined in packages/runtime/src/runtime.ts:745
Parameters
- amt: bigint
- address: string
Returns void

assertNoDuplicateTransaction

assertNoDuplicateTransaction(gtxns: EncTx[]): void

- Defined in packages/runtime/src/runtime.ts:232
Ensure no duplicate transaction in group txn

Parameters
- gtxns: EncTx[]
  
  group transaction
Returns void

createLsigAccount

createLsigAccount(program: string, args: Uint8Array[]): LogicSigAccount

- Defined in packages/runtime/src/runtime.ts:802
Creates a new account with logic signature and smart contract arguments in the runtime store. The arguments are used when we send a transaction with this account and verify it.

Parameters
- program: string
  
  TEAL code
- args: Uint8Array[]
  
  arguments passed
Returns LogicSigAccount
logic signature with arguments.

createTxnContext

createTxnContext(txnParams: ExecParams | ExecParams[]): [EncTx, EncTx[]]

- Defined in packages/runtime/src/runtime.ts:410
Creates new transaction object (tx, gtxs) from given txnParams

returns:
[current transaction, transaction group]

Parameters
- txnParams: ExecParams | ExecParams[]
  
  : Transaction parameters for current txn or txn Group
Returns [EncTx, EncTx[]]

defaultAccounts

defaultAccounts(): AccountStore[]

- Defined in packages/runtime/src/runtime.ts:114
Getter for _defaultAccounts, returns a synced version of the accounts list

Returns AccountStore[]
list of AccountStore

deployASA

deployASA(asa: string, flags: ASADeploymentFlags): ASAInfo

- Defined in packages/runtime/src/runtime.ts:484
Deploy Asset in Runtime using asa.yaml

Parameters
- asa: string
  
  ASA name
- flags: ASADeploymentFlags
  
  ASA Deployment Flags
Returns ASAInfo

deployASADef

deployASADef(asa: string, asaDef: { clawback?: string; decimals: number | bigint; defaultFrozen?: boolean; freeze?: string; manager?: string; metadataHash?: string | Uint8Array | Buffer; name?: string; note?: string; noteb64?: string; optInAccNames?: string[]; reserve?: string; total: string | number | bigint; unitName?: string; url?: string }, flags: ASADeploymentFlags): ASAInfo

- Defined in packages/runtime/src/runtime.ts:507
Deploy Asset in Runtime without using asa.yaml

Parameters
- asa: string
  
  ASA name
- asaDef: { clawback?: string; decimals: number | bigint; defaultFrozen?: boolean; freeze?: string; manager?: string; metadataHash?: string | Uint8Array | Buffer; name?: string; note?: string; noteb64?: string; optInAccNames?: string[]; reserve?: string; total: string | number | bigint; unitName?: string; url?: string }
  - Optional clawback?: string
  - decimals: number | bigint
  - Optional defaultFrozen?: boolean
  - Optional freeze?: string
  - Optional manager?: string
  - Optional metadataHash?: string | Uint8Array | Buffer
  - Optional name?: string
  - Optional note?: string
  - Optional noteb64?: string
  - Optional optInAccNames?: string[]
  - Optional reserve?: string
  - total: string | number | bigint
  - Optional unitName?: string
  - Optional url?: string
- flags: ASADeploymentFlags
  
  ASA Deployment Flags
Returns ASAInfo

deployApp

deployApp(sender: default, appDefinition: AppDefinition, payFlags: TxParams, scTmplParams?: SCParams, debugStack?: number): AppInfo

- Defined in packages/runtime/src/runtime.ts:621
deploy a new application and returns application id

Parameters
- sender: default
- appDefinition: AppDefinition
  
  app definition
- payFlags: TxParams
  
  Transaction parameters
- Optional scTmplParams: SCParams
  
  Smart Contract template parameters
- Optional debugStack: number
Returns AppInfo

executeTx

executeTx(txnParams: ExecParams[] | TransactionAndSign[], debugStack?: number): TxReceipt[]

- Defined in packages/runtime/src/runtime.ts:884
This function executes a transaction based on a smart contract logic and updates state afterwards

Parameters
- txnParams: ExecParams[] | TransactionAndSign[]
  
  : Transaction parameters
- Optional debugStack: number
Returns TxReceipt[]

fundLsig

fundLsig(from: RuntimeAccountI, to: string, amount: number): TxReceipt

- Defined in packages/runtime/src/runtime.ts:820
Transfers amount of microAlgos from from address to to address

Parameters
- from: RuntimeAccountI
  
  From account
- to: string
  
  to address
- amount: number
  
  amount of algo in microalgos
Returns TxReceipt

getAccount

getAccount(address: string): AccountStoreI

- Defined in packages/runtime/src/runtime.ts:285
Fetches account from this.store

Parameters
- address: string
  
  account address
Returns AccountStoreI

getApp

getApp(appID: number): SSCAttributesM

- Defined in packages/runtime/src/runtime.ts:269
Fetches app from this.store

Parameters
- appID: number
  
  Application Index
Returns SSCAttributesM

getAppByName

getAppByName(appName: string): undefined | AppInfo

- Defined in packages/runtime/src/runtime.ts:374
Queries app id by app name from global state. Returns undefined if app is not found.

Parameters
- appName: string
Returns undefined | AppInfo

getAppInfoFromName

getAppInfoFromName(approval: string, clear: string): undefined | AppInfo

- Defined in packages/runtime/src/runtime.ts:365
Queries app id by app name from global state. Returns undefined if app is not found. https://www.pivotaltracker.com/story/show/180142720

Parameters
- approval: string
- clear: string
Returns undefined | AppInfo

getAssetAccount

getAssetAccount(assetId: number): AccountStoreI

- Defined in packages/runtime/src/runtime.ts:331
Returns asset creator account or throws error is it doesn't exist

Parameters
- assetId: number
  
  Index
Returns AccountStoreI

getAssetDef

getAssetDef(assetId: number): AssetParams

- Defined in packages/runtime/src/runtime.ts:343
Returns Asset Definitions

Parameters
- assetId: number
  
  Asset Index
Returns AssetParams

getAssetHolding

getAssetHolding(assetIndex: number, address: string): AssetHoldingM

- Defined in packages/runtime/src/runtime.ts:550
Returns Asset Holding from an account

Parameters
- assetIndex: number
  
  Asset Index
- address: string
  
  address of account to get holding from
Returns AssetHoldingM

getAssetInfoFromName

getAssetInfoFromName(name: string): undefined | ASAInfo

- Defined in packages/runtime/src/runtime.ts:354
Queries asset id by asset name from global state. Returns undefined if asset is not found.

Parameters
- name: string
  
  Asset name
Returns undefined | ASAInfo

getGlobalState

getGlobalState(appID: number, key: string | Uint8Array): undefined | StackElem

- Defined in packages/runtime/src/runtime.ts:296
Fetches global state value for key present in creator's global state for given appID, returns undefined otherwise

Parameters
- appID: number
- key: string | Uint8Array
Returns undefined | StackElem

getLocalState

getLocalState(appID: number, accountAddr: string, key: string | Uint8Array): undefined | StackElem

- Defined in packages/runtime/src/runtime.ts:314
Fetches local state for account address and application index

Parameters
- appID: number
  
  application index
- accountAddr: string
  
  address for which local state needs to be retrieved
- key: string | Uint8Array
Returns undefined | StackElem

getRound

getRound(): number

- Defined in packages/runtime/src/runtime.ts:254
Return current round

Returns number

getTimestamp

getTimestamp(): number

- Defined in packages/runtime/src/runtime.ts:261
Return current timestamp

Returns number

getTxReceipt

getTxReceipt(txID: string): undefined | TxReceipt

- Defined in packages/runtime/src/runtime.ts:122
Returns transaction receipt for a particular transaction

Parameters
- txID: string
  
  transaction ID
Returns undefined | TxReceipt

initializeAccounts

initializeAccounts(accounts: AccountStoreI[]): void

- Defined in packages/runtime/src/runtime.ts:382
Setup initial accounts as {address: SDKAccount}. This should be called only when initializing Runtime.

Parameters
- accounts: AccountStoreI[]
Returns void

loadLogic

loadLogic(fileName: string, scTmplParams?: SCParams, logs?: boolean): LogicSigAccount

- Defined in packages/runtime/src/runtime.ts:789
Loads logic signature for contract mode, creates a new runtime account associated with lsig

Parameters
- fileName: string
  
  ASC filename
- Optional scTmplParams: SCParams
- logs: boolean = true
  
  only show logs on console when set as true. By default this value is true
Returns LogicSigAccount
loaded logic signature from assets/.teal

mkAssetCreateTx

mkAssetCreateTx(name: string, flags: ASADeploymentFlags, asaDef: AssetParams): void

- Defined in packages/runtime/src/runtime.ts:440
Parameters
- name: string
- flags: ASADeploymentFlags
- asaDef: AssetParams
Returns void

optInToASA

optInToASA(assetIndex: number, address: string, flags: TxParams): TxReceipt

- Defined in packages/runtime/src/runtime.ts:538
Asset Opt-In for account in Runtime

Parameters
- assetIndex: number
  
  Asset Index
- address: string
  
  Account address to opt-into asset
- flags: TxParams
  
  Transaction Parameters
Returns TxReceipt

optInToASAMultiple

optInToASAMultiple(assetID: number, accounts?: string[]): void

- Defined in packages/runtime/src/runtime.ts:520
Opt-In to all accounts given in asa.yaml to a specific asset.

Parameters
- assetID: number
  
  Asset Index
- Optional accounts: string[]
  
  list account opt to asa
Returns void

optInToApp

optInToApp(accountAddr: string, appID: number, flags: AppOptionalFlags, payFlags: TxParams, debugStack?: number): TxReceipt

- Defined in packages/runtime/src/runtime.ts:670
Account address opt-in for application Id

Parameters
- accountAddr: string
  
  Account address
- appID: number
  
  Application Id
- flags: AppOptionalFlags
  
  Stateful smart contract transaction optional parameters (accounts, args..)
- payFlags: TxParams
  
  Transaction Parameters
- Optional debugStack: number
Returns TxReceipt

resetDefaultAccounts

resetDefaultAccounts(): void

- Defined in packages/runtime/src/runtime.ts:106
Resets the state of the default accounts

Returns void

run

run(program: string, executionMode: ExecutionMode, indexInGroup: number, debugStack?: number): TxReceipt

- Defined in packages/runtime/src/runtime.ts:972
This function executes TEAL code line by line

Parameters
- program: string
  
  : teal code as string
- executionMode: ExecutionMode
  
  : execution Mode (Stateless or Stateful)
- indexInGroup: number
- Optional debugStack: number
Returns TxReceipt

setRoundAndTimestamp

setRoundAndTimestamp(r: number, timestamp: number): void

- Defined in packages/runtime/src/runtime.ts:246
set current round with timestamp for a block

Parameters
- r: number
  
  current round
- timestamp: number
  
  block's timestamp
Returns void

updateApp

updateApp(appName: string, senderAddr: string, appID: number, newAppCode: SmartContract, payFlags: TxParams, flags: AppOptionalFlags, scTmplParams?: SCParams, debugStack?: number): TxReceipt

- Defined in packages/runtime/src/runtime.ts:724
Update application

Parameters
- appName: string
  
  application Name. Note in runtime application name just placeholder params
- senderAddr: string
  
  sender address
- appID: number
  
  application Id
- newAppCode: SmartContract
  
  new application source code
- payFlags: TxParams
  
  Transaction parameters
- flags: AppOptionalFlags
  
  Stateful smart contract transaction optional parameters (accounts, args..)
- Optional scTmplParams: SCParams
- Optional debugStack: number
Returns TxReceipt

validateAccountSignature

validateAccountSignature(txParam: ExecParams): void

- Defined in packages/runtime/src/runtime.ts:761
Validate signature for Algorand account on transaction params. Include check spending account when creating a transaction from Algorand account Throw RuntimeError if signature is invalid.

Parameters
- txParam: ExecParams
  
  transaction parameters.
Returns void

validateLsigAndRun

validateLsigAndRun(txnParam: ExecParams, debugStack?: number): TxReceipt

- Defined in packages/runtime/src/runtime.ts:838
validate logic signature and teal logic

Parameters
- txnParam: ExecParams
  
  Transaction Parameters
- Optional debugStack: number
Returns TxReceipt

validateTxRound

validateTxRound(gtxns: EncTx[]): void

- Defined in packages/runtime/src/runtime.ts:215
Validate first and last rounds of transaction using current round

Parameters
- gtxns: EncTx[]
  
  transactions
Returns void

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

accounts: AccountStoreI[]

Returns Runtime

Properties

ctx

loadedAssetsDefs

Optional parentCtx

Accessors

defaultBalance

Returns number

Methods

_setupDefaultAccounts

Returns AccountStore[]

addASADef

Parameters

asa: string

Optional clawback?: string

decimals: number | bigint

Optional defaultFrozen?: boolean

Optional freeze?: string

Optional manager?: string

Optional metadataHash?: string | Uint8Array | Buffer

Optional name?: string

Optional note?: string

Optional noteb64?: string

Optional optInAccNames?: string[]

Optional reserve?: string

total: string | number | bigint

Optional unitName?: string

Optional url?: string

flags: ASADeploymentFlags

Returns ASAInfo

addApp

Parameters

approvalProgram: string

clearProgram: string

flags: AppDeploymentFlags

payFlags: TxParams

Optional debugStack: number

Returns AppInfo

addAsset

Parameters

asa: string

flags: ASADeploymentFlags

Returns ASAInfo

addCtxAppCreateTxn

Parameters

creator: default

appDef: AppDefinition

payFlags: TxParams

Returns void

addCtxAppUpdateTx

Parameters

senderAddr: string

appID: number

payFlags: TxParams

flags: AppOptionalFlags

Returns void

addCtxOptInTx

Parameters

senderAddr: string

appID: number

payFlags: TxParams

flags: AppOptionalFlags

Returns void

assertAccountDefined

Parameters

address: string

Optional a: AccountStoreI

Optional line: number

Returns AccountStoreI

assertAddressDefined