Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,104 @@ | ||
| // Copyright (C) 2024, Ava Labs, Inc. All rights reserved. | ||
| // See the file LICENSE for licensing terms. | ||
|
|
||
| package examples | ||
|
|
||
| import ( | ||
| "context" | ||
| "fmt" | ||
| "github.com/ava-labs/avalanche-tooling-sdk-go/avalanche" | ||
| "github.com/ava-labs/avalanche-tooling-sdk-go/keychain" | ||
| "github.com/ava-labs/avalanche-tooling-sdk-go/subnet" | ||
| "github.com/ava-labs/avalanche-tooling-sdk-go/wallet" | ||
| "github.com/ava-labs/avalanchego/ids" | ||
| "github.com/ava-labs/avalanchego/utils/set" | ||
| "github.com/ava-labs/avalanchego/vms/secp256k1fx" | ||
| "github.com/ava-labs/avalanchego/wallet/subnet/primary" | ||
| "time" | ||
| ) | ||
|
|
||
| func DeploySubnetMultiSig() { | ||
| subnetParams := getDefaultSubnetEVMGenesis() | ||
| // Create new Subnet EVM genesis | ||
| newSubnet, _ := subnet.New(&subnetParams) | ||
|
|
||
| network := avalanche.FujiNetwork() | ||
|
|
||
| // Create three keys that will be used as control keys of the subnet | ||
| // NewKeychain will generate a new key pair in the provided path if no .pk file currently | ||
| // exists in the provided path | ||
| keychainA, _ := keychain.NewKeychain(network, "KEY_PATH_A") | ||
| keychainB, _ := keychain.NewKeychain(network, "KEY_PATH_B") | ||
| keychainC, _ := keychain.NewKeychain(network, "KEY_PATH_C") | ||
|
|
||
| // In this example, we are using the fee-paying key generated above also as control key | ||
| // and subnet auth key | ||
|
|
||
| // control keys are a list of keys that are permitted to make changes to a Subnet | ||
| // such as creating a blockchain in the Subnet and adding validators to the Subnet | ||
| controlKeys := []ids.ShortID{} | ||
| controlKeys = append(controlKeys, keychainA.Addresses().List()[0]) | ||
| controlKeys = append(controlKeys, keychainB.Addresses().List()[0]) | ||
| controlKeys = append(controlKeys, keychainC.Addresses().List()[0]) | ||
|
|
||
| // subnet auth keys are a subset of control keys | ||
| // | ||
| // they are the keys that will be used to sign transactions that modify a Subnet | ||
| // number of keys in subnetAuthKeys has to be more than or equal to threshold | ||
| // all keys in subnetAuthKeys have to sign the transaction before the transaction | ||
| // can be committed on chain | ||
| subnetAuthKeys := []ids.ShortID{} | ||
| // In this example, we are setting Key A and Key B as the subnet auth keys | ||
| subnetAuthKeys = append(subnetAuthKeys, keychainA.Addresses().List()[0]) | ||
| subnetAuthKeys = append(subnetAuthKeys, keychainB.Addresses().List()[0]) | ||
| // at least two signatures are required to be able to send the CreateChain transaction on-chain | ||
| // note that threshold does not apply to CreateSubnet transaction | ||
| threshold := 2 | ||
| newSubnet.SetSubnetCreateParams(controlKeys, uint32(threshold)) | ||
|
|
||
| // Key A will be used for paying the transaction fees of CreateSubnetTx and CreateChainTx | ||
| walletA, _ := wallet.New( | ||
| context.Background(), | ||
| &primary.WalletConfig{ | ||
| URI: network.Endpoint, | ||
| AVAXKeychain: keychainA.Keychain, | ||
| EthKeychain: secp256k1fx.NewKeychain(), | ||
| PChainTxsToFetch: nil, | ||
| }, | ||
| ) | ||
|
|
||
| deploySubnetTx, _ := newSubnet.CreateSubnetTx(walletA) | ||
| subnetID, _ := newSubnet.Commit(*deploySubnetTx, walletA, true) | ||
| fmt.Printf("subnetID %s \n", subnetID.String()) | ||
|
|
||
| // we need to wait to allow the transaction to reach other nodes in Fuji | ||
| time.Sleep(2 * time.Second) | ||
|
|
||
| newSubnet.SetBlockchainCreateParams(subnetAuthKeys) | ||
| deployChainTx, err := newSubnet.CreateBlockchainTx(walletA) | ||
| if err != nil { | ||
| fmt.Errorf("error signing tx walletA: %w", err) | ||
| } | ||
|
|
||
| // we need to include subnetID in PChainTxsToFetch when creating second wallet | ||
| // so that the wallet can fetch the CreateSubnet P-chain transaction to be able to | ||
| // generate transactions. | ||
| walletB, _ := wallet.New( | ||
| context.Background(), | ||
| &primary.WalletConfig{ | ||
| URI: network.Endpoint, | ||
| AVAXKeychain: keychainB.Keychain, | ||
| EthKeychain: secp256k1fx.NewKeychain(), | ||
| PChainTxsToFetch: set.Of(subnetID), | ||
| }, | ||
| ) | ||
|
|
||
| // sign with second wallet so that we have 2/2 threshold reached | ||
| if err := walletB.P().Signer().Sign(context.Background(), deployChainTx.PChainTx); err != nil { | ||
| fmt.Errorf("error signing tx walletB: %w", err) | ||
| } | ||
|
|
||
| // since we have two signatures, we can now commit the transaction on chain | ||
| blockchainID, _ := newSubnet.Commit(*deployChainTx, walletA, true) | ||
| fmt.Printf("blockchainID %s \n", blockchainID.String()) | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,71 @@ | ||
| // Copyright (C) 2024, Ava Labs, Inc. All rights reserved. | ||
| // See the file LICENSE for licensing terms. | ||
|
|
||
| package subnet | ||
|
|
||
| import ( | ||
| "errors" | ||
| "fmt" | ||
| "time" | ||
|
|
||
| "github.com/ava-labs/avalanche-tooling-sdk-go/multisig" | ||
| "github.com/ava-labs/avalanche-tooling-sdk-go/wallet" | ||
| "github.com/ava-labs/avalanchego/ids" | ||
| "github.com/ava-labs/avalanchego/vms/platformvm/txs" | ||
| "golang.org/x/net/context" | ||
| ) | ||
|
|
||
| type ValidatorParams struct { | ||
| NodeID ids.NodeID | ||
|
|
||
| Duration time.Duration | ||
|
|
||
| Weight uint64 | ||
| } | ||
|
|
||
| var ( | ||
| ErrEmptyValidatorNodeID = errors.New("validator node id is not provided") | ||
| ErrEmptyValidatorDuration = errors.New("validator duration is not provided") | ||
| ErrEmptyValidatorWeight = errors.New("validator weight is not provided") | ||
| ErrEmptySubnetID = errors.New("subnet ID is not provided") | ||
| ) | ||
|
|
||
| // AddValidator adds validator to subnet | ||
| // Before an Avalanche Node can be added as a validator to a Subnet, the node must already be | ||
| // tracking the subnet | ||
| // TODO: add more description once node join subnet sdk is done | ||
| func (c *Subnet) AddValidator(wallet wallet.Wallet, validatorInput ValidatorParams) (*multisig.Multisig, error) { | ||
| if validatorInput.NodeID == ids.EmptyNodeID { | ||
| return nil, ErrEmptyValidatorNodeID | ||
| } | ||
| if validatorInput.Duration == 0 { | ||
| return nil, ErrEmptyValidatorDuration | ||
| } | ||
| if validatorInput.Weight == 0 { | ||
| return nil, ErrEmptyValidatorWeight | ||
| } | ||
| if c.SubnetID == ids.Empty { | ||
| return nil, ErrEmptySubnetID | ||
| } | ||
|
|
||
| wallet.SetSubnetAuthMultisig(c.DeployInfo.SubnetAuthKeys) | ||
|
|
||
| validator := &txs.SubnetValidator{ | ||
| Validator: txs.Validator{ | ||
| NodeID: validatorInput.NodeID, | ||
| End: uint64(time.Now().Add(validatorInput.Duration).Unix()), | ||
| Wght: validatorInput.Weight, | ||
| }, | ||
| Subnet: c.SubnetID, | ||
| } | ||
|
|
||
| unsignedTx, err := wallet.P().Builder().NewAddSubnetValidatorTx(validator) | ||
| if err != nil { | ||
| return nil, fmt.Errorf("error building tx: %w", err) | ||
| } | ||
| tx := txs.Tx{Unsigned: unsignedTx} | ||
| if err := wallet.P().Signer().Sign(context.Background(), &tx); err != nil { | ||
| return nil, fmt.Errorf("error signing tx: %w", err) | ||
| } | ||
| return multisig.New(&tx), nil | ||
| } | ||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters