client

Overview ¶

Package client provides a simple RMB interface to work with the node.

Package client for node client ¶

Package client provides a simple RMB interface to work with the node.

Requirements ¶

1. A msg bus instance must be running on the node. this client uses RMB (message bus) to send messages to nodes, and get the responses. 2. A valid ed25519 key pair. this key is used to sign deployments and MUST be the same key used to configure the local twin on substrate.

Simple deployment ¶

create an instance from the default rmb client. ``` cl, err := rmb.Default()

if err != nil {
	panic(err)
}

``` then create an instance of the node client ``` node := client.NewNodeClient(NodeTwinID, cl) ``` define your deployment object ```

dl := gridtypes.Deployment{
	Version: Version,
	twinID:  Twin, //LocalTwin,
	// this contract id must match the one on substrate
	Workloads: []gridtypes.Workload{
		network(), // network workload definition
		zmount(), // zmount workload definition
		publicip(), // public ip definition
		zmachine(), // zmachine definition
	},
	SignatureRequirement: gridtypes.SignatureRequirement{
		WeightRequired: 1,
		Requests: []gridtypes.SignatureRequest{
			{
				twinID: Twin,
				Weight: 1,
			},
		},
	},
}

``` compute hash ``` hash, err := dl.ChallengeHash()

if err != nil {
	panic("failed to create hash")
}

``` create the contract and ge the contract id then “ dl.ContractID = 11 // from substrate ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second) defer cancel() err = node.DeploymentDeploy(ctx, dl)

if err != nil {
	panic(err)
}

```