Class Container<C, I>

A private local instance of a network, running in a container managed by @fadroma/oci.

Type Parameters

C extends Chain.Connection
I extends Chain.Identity

Hierarchy

DevnetContainerConfig
- Container

Implements

Chain.Backend

Constructors

constructor

new Container<C, I>(options?): Container<C, I>
Type Parameters
- C extends Chain.Connection
- I extends Chain.Identity
Parameters
- options: Partial<Omit<Container<C, I>, "container"> & {
      container: Partial<Omit<Container, "image"> & {
          image: Partial<Image>;
      }>;
  }> = {}
Returns Container<C, I>
Overrides DevnetContainerConfig.constructor
- Defined in devnet/devnet-base.ts:154

Properties

Connection

Connection: (new (...args) => C)

Connection class for this devnet.

Type declaration

- new (...args): C
- Connection class for this devnet.
  Parameters
  - Rest ...args: unknown[]
  Returns C

Identity

Identity: (new (...args) => I)

Identity class for this devnet.

Type declaration

- new (...args): I
- Identity class for this devnet.
  Parameters
  - Rest ...args: unknown[]
  Returns I

`Optional` chainId

chainId?: string

Chain ID of chain node running inside devnet container.

container

container: Container

`Readonly` created

created: Promise<Container<C, I>>

Wait for the devnet to be created.

`Optional` exitHandler

exitHandler?: ((...args) => void)

The exit handler that cleans up external resources.

Type declaration

- (...args): void
- The exit handler that cleans up external resources.
  Parameters
  - Rest ...args: any
  Returns void

`Optional` gasToken

gasToken?: Native

Denomination of base gas token for this chain.

genesisAccounts

genesisAccounts: Record<string, string | number | bigint> = {}

Initial accounts.

genesisUploads

genesisUploads: Record<string, Partial<CompiledCode>> = {}

Initial uploads.

initScript

initScript: Path = ...

If set, overrides the script that launches the devnet in the container.

log

log: Core.Console = ...

Logger.

`Optional` nodeBinary

nodeBinary?: string

Name of binary in container to start.

nodeHost

nodeHost: string = 'localhost'

The hostname of the API URL.

`Optional` nodePort

nodePort?: string | number

The port of the API URL.

`Optional` nodePortMode

nodePortMode?: APIMode

Which service does the API URL port correspond to.

nodeProtocol

nodeProtocol: string = 'http'

The protocol of the API URL without the trailing colon.

onScriptExit

onScriptExit: "remove" | "pause" | "remain" = 'remove'

What to do with the devnet once the process that has spawned it exits.

"remain": the devnet container keeps running
"pause": the devnet container is stopped
"remove": the devnet container is stopped and removed, along with the state directory

`Readonly` paused

paused: Promise<Container<C, I>>

Wait for the devnet to be stopped.

platformName

Name of devnet platform.

platformVersion

platformVersion: string

Version of devnet platform.

`Readonly` removed

removed: Promise<Container<C, I>>

Wait for the devnet to be removed.

running

running: boolean = false

Whether the devnet container is started.

`Readonly` started

started: Promise<Container<C, I>>

Wait for the devnet to be started.

stateRoot

stateRoot: Directory

This directory contains the state of all devnets, e.g. ~/.local/share/fadroma/devnets. The devnet container will create a subdirectory named after the chain ID.

`Optional` url

url?: string | URL

URL for connecting to a remote devnet.

verbose

verbose: boolean = false

Whether more detailed output is preferred.

waitMore

waitMore: number = 7

Seconds to wait after first block. Tests override this to save time.

waitPort

waitPort: ((__namedParameters) => Promise<void>) = waitPort

Function that waits for port to open after launching container. Tests override this to save time.

Type declaration

- (__namedParameters): Promise<void>
- Function that waits for port to open after launching container. Tests override this to save time.
  Parameters
  - __namedParameters: {
        host: string;
        interval?: number;
        port: number;
        retries?: number;
    }
    - host: string
    - Optional interval?: number
    - port: number
    - Optional retries?: number
  Returns Promise<void>

waitString

waitString: string = ''

Once this phrase is encountered in the log output from the container, the devnet is ready to accept requests.

Accessors

platform

get platform(): string
Returns string
Inherited from DevnetContainerConfig.platform
- Defined in devnet/devnet-base.ts:108

runFile

get runFile(): File
This file is created when the container is started. Deleting it tells the script running inside the container to kill the devnet.

Returns File
Inherited from DevnetContainerConfig.runFile
- Defined in devnet/devnet-base.ts:136

stateDir

get stateDir(): Directory
This directory contains the state of the devnet, such as statefile, runfile, genesis accounts.

Returns Directory
Inherited from DevnetContainerConfig.stateDir
- Defined in devnet/devnet-base.ts:120

stateFile

get stateFile(): File
This file contains the state of the devnet, such as container ID.

Returns File
Inherited from DevnetContainerConfig.stateFile
- Defined in devnet/devnet-base.ts:128

Methods

connect

connect(parameter?): Promise<C>
Obtain a Connection object to this devnet, optionally with a specific Identity.
Parameters
- Optional parameter: string | Partial<I>
Returns Promise<C>
Implementation of Backend.connect
- Defined in devnet/devnet-base.ts:189

export

export(repository?, tag?): Promise<any>
Export the contents of the devnet as a container image.
Parameters
- repository: string = ...
- tag: string = ...
Returns Promise<any>
- Defined in devnet/devnet-base.ts:203

getIdentity

getIdentity(name): Promise<Partial<Chain.Identity> & {
mnemonic: string;
}>
Get info for named genesis account, including the mnemonic
Parameters
- name: string | {
  name?: string;
  }
Returns Promise<Partial<Chain.Identity> & {
mnemonic: string;
}>
Implementation of Backend.getIdentity
- Defined in devnet/devnet-base.ts:197

Class Container<C, I>

Type Parameters

C extends Chain.Connection

I extends Chain.Identity

Hierarchy

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Type Parameters

C extends Chain.Connection

I extends Chain.Identity

Parameters

options: Partial<Omit<Container<C, I>, "container"> & { container: Partial<Omit<Container, "image"> & { image: Partial<Image>; }>; }> = {}

Returns Container<C, I>

Properties

Connection

Type declaration

Parameters

Rest ...args: unknown[]

Returns C

Identity

Type declaration

Parameters

Rest ...args: unknown[]

Returns I

Optional chainId

container

Readonly created

Optional exitHandler

Type declaration

Parameters

Rest ...args: any

Returns void

Optional gasToken

genesisAccounts

genesisUploads

initScript

log

Optional nodeBinary

nodeHost

Optional nodePort

Optional nodePortMode

nodeProtocol

onScriptExit

Readonly paused

platformName

platformVersion

Readonly removed

running

Readonly started

stateRoot

Optional url

verbose

waitMore

waitPort

Type declaration

Parameters

__namedParameters: { host: string; interval?: number; port: number; retries?: number; }

host: string

Optional interval?: number

port: number

Optional retries?: number

Returns Promise<void>

waitString

Accessors

platform

Returns string

runFile

Returns File

stateDir

Returns Directory

stateFile

Returns File

Methods

connect

options: Partial<Omit<Container<C, I>, "container"> & {
container: Partial<Omit<Container, "image"> & {
image: Partial<Image>;
}>;
}> = {}

`Rest` ...args: unknown[]

`Rest` ...args: unknown[]

`Optional` chainId

`Readonly` created

`Optional` exitHandler

`Rest` ...args: any

`Optional` gasToken

`Optional` nodeBinary

`Optional` nodePort

`Optional` nodePortMode

`Readonly` paused

`Readonly` removed

`Readonly` started

`Optional` url

__namedParameters: {
host: string;
interval?: number;
port: number;
retries?: number;
}

`Optional` interval?: number

`Optional` retries?: number

`Optional` parameter: string | Partial<I>

name: string | {
name?: string;
}

Returns Promise<Partial<Chain.Identity> & {
mnemonic: string;
}>