https://github.com/blockdaemon/demo-buildervault-wallettransact
https://github.com/blockdaemon/demo-buildervault-wallettransact
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/blockdaemon/demo-buildervault-wallettransact
- Owner: Blockdaemon
- License: other
- Created: 2024-04-27T00:32:22.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-09-27T00:08:26.000Z (7 months ago)
- Last Synced: 2025-01-13T14:21:23.796Z (4 months ago)
- Language: Go
- Size: 27.3 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Ethereum transaction signing with Builder Vault + WalletTransact
```mermaid
sequenceDiagram
autonumber
actor client as client application
participant Blockchain as Blockdaemon Wallet Transact
REST API
box Builder Vault
participant TSM1 as MPC Wallet
(private key share 1)
participant TSM2 as MPC Wallet
(private key share 2)
participant TSM3 as MPC Wallet
(private key share 3)
end
#note over client,TSM2: Create wallet
opt
client ->> TSM1: create master key
client ->> TSM1: create wallet
end
#note over client,TSM2: Create transations
client ->> Blockchain: get unsigned tx
(from addr, to addr, amount)
Blockchain -->> client: return unsigned tx
(nonce, gas)
client ->> TSM1: request signature (unsigned tx hash)
TSM1 -->> client: return partial signature
client ->> TSM2: request signature (unsigned tx hash)
TSM2 -->> client: return partial signature
client ->> TSM3: request signature (unsigned tx hash)
TSM3 -->> client: return partial signature
client ->> client: combine partial signatures
client ->> Blockchain: compile unsigned tx with signature and broadcast
(unsigned tx, signature, public key)
```
### Watch the video
[](https://youtu.be/irgfKhJVq6Q)
### Prerequisites
- Go https://go.dev/doc/install or use [code-spaces](https://codespaces.new/Blockdaemon/demo-buildervault-wallettransact?quickstart=1)
- Register for a demo Builder Vault tenant: https://www.blockdaemon.com/get-started/builder-vault-sandbox-registration
- Download SDK bundle provided in registration email (extract authentication certificates)
- Place Builder Vault authentication certificate key-pair in working directory
- Register for Blockdaemon API Suite Free key and set as environment variable ACCESS_TOKEN
### Step 1. Create Wallet with Builder Vault and Ethereum chain path
```shell
go run 1-create-wallet/main.go
```
- note the new Ethereum Wallet public key (to be used for future signing)
- note the new Ethereum Wallet address and fund it with Sepolia ETH https://sepolia-faucet.pk910.de
- note the Builder Vault Master Key ID (to be used for future signing)
### Step 2. Craft an unsigned transaction
- set the wallet address created in step 1
- set the destination address to send funds to
```shell
go run 2-craft-transaction/main.go
```
- check the wallet balance is not 0
- note the raw unsigned transaction (to be broadcast once signed)
- note the unsigned transaction hash (to be signed by Builder Vault)
- (optional) decode the raw unsigned transaction to inspect the Blockdaemon provided attributes (https://rawtxdecode.in)
### Step 3. Sign transaction with BuilderVault wallet
- set the Builder Vault Master Key ID to be used for signing (created in step 1)
- set the unsigned transaction hash to be signed by Builder Vault (created in step 2)
```shell
go run 3-sign-transaction/main.go
```
- note the transaction signature
### Step 4. Broadcast signed raw transaction
- set the wallet compressed public key (created in step 1)
- set the raw unsigned transaction (created in step 2)
- set the transaction signature hash (created in step 3)
```shell
go run 4-broadcast-signed-transaction/main.go
```
- check the transaction hash on a block explorer