Skip to content

Commit 4c86891

Browse files
danielzhao122danielzhao122
committed
feat: add example scripts
TICKET: WP-6461
1 parent fe01aef commit 4c86891

File tree

2 files changed

+234
-0
lines changed

2 files changed

+234
-0
lines changed

‎examples/js/eth/verify-wallet-address-sdk.js‎

Lines changed: 111 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,111 @@
1+
/**
2+
* Verify that an address belongs to a wallet using the BitGo SDK.
3+
*
4+
* This example demonstrates using the SDK's isWalletAddress method which verifies:
5+
* - Forwarder addresses (deposit addresses)
6+
* - Base addresses (wallet contract addresses)
7+
*
8+
* Copyright 2024, BitGo, Inc. All Rights Reserved.
9+
*/
10+
11+
const BitGoJS = require('bitgo');
12+
13+
const coin = 'hteth'; // change to 'eth' for production
14+
const env = 'test'; // change to 'prod' for production
15+
16+
// TODO: set your access token here
17+
const accessToken = '';
18+
19+
// TODO: set your wallet ID here
20+
const walletId = '';
21+
22+
async function main() {
23+
// Initialize BitGo SDK
24+
const bitgo = new BitGoJS.BitGo({ env, accessToken });
25+
26+
console.log('Step 1: Getting wallet...');
27+
const wallet = await bitgo.coin(coin).wallets().get({ id: walletId });
28+
29+
const coinSpecific = wallet.coinSpecific();
30+
const baseAddress = coinSpecific.baseAddress;
31+
const walletVersion = coinSpecific.walletVersion;
32+
const feeAddress = coinSpecific.feeAddress;
33+
const walletSalt = coinSpecific.salt;
34+
35+
console.log(' Base Address:', baseAddress);
36+
console.log(' Wallet Version:', walletVersion);
37+
38+
console.log('Step 2: Fetching keychains...');
39+
const keychainIds = wallet.keyIds();
40+
const keychains = [];
41+
42+
for (const keychainId of keychainIds) {
43+
const keychain = await bitgo.coin(coin).keychains().get({ id: keychainId });
44+
45+
// For TSS keychains, derive pub from commonKeychain (first 66 characters)
46+
const pub = keychain.pub || (keychain.commonKeychain && keychain.commonKeychain.slice(0, 66));
47+
48+
if (!pub) {
49+
throw new Error(`Unable to derive pub for keychain ${keychainId}`);
50+
}
51+
52+
keychains.push({
53+
pub: pub,
54+
...(keychain.ethAddress && { ethAddress: keychain.ethAddress }),
55+
...(keychain.commonKeychain && { commonKeychain: keychain.commonKeychain })
56+
});
57+
}
58+
console.log(' Retrieved', keychains.length, 'keychains');
59+
60+
console.log('Step 3: Getting address details...');
61+
const receiveAddress = wallet.receiveAddress();
62+
const addressObj = await wallet.getAddress({ address: receiveAddress });
63+
64+
const addressIndex = addressObj.index;
65+
const forwarderVersion = addressObj.coinSpecific?.forwarderVersion;
66+
const forwarderSalt = addressObj.coinSpecific?.salt;
67+
68+
console.log(' Address:', receiveAddress);
69+
console.log(' Index:', addressIndex);
70+
console.log(' Forwarder Version:', forwarderVersion);
71+
72+
console.log('Step 4: Verifying forwarder address using SDK...');
73+
const forwarderParams = {
74+
address: receiveAddress,
75+
keychains: keychains,
76+
baseAddress: baseAddress,
77+
walletVersion: walletVersion,
78+
index: addressIndex,
79+
coinSpecific: {
80+
forwarderVersion: forwarderVersion,
81+
salt: forwarderSalt,
82+
feeAddress: feeAddress,
83+
baseAddress: baseAddress
84+
}
85+
};
86+
87+
const forwarderResult = await wallet.baseCoin.isWalletAddress(forwarderParams);
88+
console.log(' Result:', forwarderResult ? '✓ Valid' : '✗ Invalid');
89+
90+
console.log('Step 5: Verifying base address using SDK...');
91+
const baseAddressParams = {
92+
address: baseAddress,
93+
keychains: keychains,
94+
baseAddress: baseAddress,
95+
walletVersion: walletVersion,
96+
index: 0,
97+
coinSpecific: {
98+
salt: walletSalt,
99+
feeAddress: feeAddress,
100+
baseAddress: baseAddress
101+
}
102+
};
103+
104+
const baseResult = await wallet.baseCoin.isWalletAddress(baseAddressParams);
105+
console.log(' Result:', baseResult ? '✓ Valid' : '✗ Invalid');
106+
107+
console.log('\n' + (forwarderResult && baseResult ? '✅ Success: Both addresses verified' : '❌ Failed: Verification failed'));
108+
}
109+
110+
main().catch((e) => console.error(e));
111+

‎examples/js/eth/verify-wallet-address.js‎

Lines changed: 123 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,123 @@
1+
/**
2+
* Verify that an address belongs to a wallet using the BitGo Express API.
3+
*
4+
* This example demonstrates the isWalletAddress endpoint which verifies:
5+
* - Forwarder addresses (deposit addresses)
6+
* - Base addresses (wallet contract addresses)
7+
*
8+
* Copyright 2024, BitGo, Inc. All Rights Reserved.
9+
*/
10+
11+
const fetch = require('node-fetch');
12+
13+
const coin = 'hteth'; // change to 'eth' for production
14+
15+
// TODO: set your access token here
16+
const accessToken = '';
17+
18+
// TODO: set your wallet ID here
19+
const walletId = '';
20+
21+
const expressUrl = '';
22+
23+
// Helper function to make API requests to Express
24+
async function apiRequest(method, endpoint, body = null) {
25+
const response = await fetch(`${expressUrl}${endpoint}`, {
26+
method,
27+
headers: {
28+
'Authorization': `Bearer ${accessToken}`,
29+
'Content-Type': 'application/json'
30+
},
31+
body: body ? JSON.stringify(body) : null
32+
});
33+
34+
if (!response.ok) {
35+
throw new Error(`HTTP ${response.status}: ${await response.text()}`);
36+
}
37+
38+
return await response.json();
39+
}
40+
41+
async function main() {
42+
console.log('Step 1: Fetching wallet data...');
43+
const wallet = await apiRequest('GET', `/api/v2/${coin}/wallet/${walletId}`);
44+
45+
const keychainIds = wallet.keys;
46+
const baseAddress = wallet.coinSpecific.baseAddress;
47+
const walletVersion = wallet.coinSpecific.walletVersion;
48+
const feeAddress = wallet.coinSpecific.feeAddress;
49+
const walletSalt = wallet.coinSpecific.salt;
50+
const addressToVerify = wallet.receiveAddress.address;
51+
52+
console.log(' Base Address:', baseAddress);
53+
console.log(' Wallet Version:', walletVersion);
54+
55+
console.log('Step 2: Fetching keychains...');
56+
const keychains = [];
57+
for (const keychainId of keychainIds) {
58+
const keychain = await apiRequest('GET', `/api/v2/${coin}/key/${keychainId}`);
59+
60+
// For TSS keychains, derive pub from commonKeychain (first 66 characters)
61+
const pub = keychain.pub || (keychain.commonKeychain && keychain.commonKeychain.slice(0, 66));
62+
63+
if (!pub) {
64+
throw new Error(`Unable to derive pub for keychain ${keychainId}`);
65+
}
66+
67+
keychains.push({
68+
pub: pub,
69+
...(keychain.ethAddress && { ethAddress: keychain.ethAddress }),
70+
...(keychain.commonKeychain && { commonKeychain: keychain.commonKeychain })
71+
});
72+
}
73+
console.log(' Retrieved', keychains.length, 'keychains');
74+
75+
console.log('Step 3: Fetching address details...');
76+
const addressData = await apiRequest('GET', `/api/v2/${coin}/wallet/${walletId}/address/${addressToVerify}`);
77+
78+
const addressIndex = addressData.index;
79+
const forwarderVersion = addressData.coinSpecific?.forwarderVersion;
80+
const forwarderSalt = addressData.coinSpecific?.salt;
81+
82+
console.log(' Address:', addressToVerify);
83+
console.log(' Index:', addressIndex);
84+
console.log(' Forwarder Version:', forwarderVersion);
85+
86+
console.log('Step 4: Verifying forwarder address...');
87+
const forwarderParams = {
88+
address: addressToVerify,
89+
keychains: keychains,
90+
baseAddress: baseAddress,
91+
walletVersion: walletVersion,
92+
index: addressIndex,
93+
coinSpecific: {
94+
forwarderVersion: forwarderVersion,
95+
salt: forwarderSalt,
96+
feeAddress: feeAddress,
97+
baseAddress: baseAddress
98+
}
99+
};
100+
101+
const forwarderResult = await apiRequest('POST', `/api/v2/${coin}/wallet/${walletId}/iswalletaddress`, forwarderParams);
102+
console.log(' Result:', forwarderResult ? '✓ Valid' : '✗ Invalid');
103+
104+
console.log('Step 5: Verifying base address...');
105+
const baseAddressParams = {
106+
address: baseAddress,
107+
keychains: keychains,
108+
baseAddress: baseAddress,
109+
walletVersion: walletVersion,
110+
index: 0,
111+
coinSpecific: {
112+
salt: walletSalt,
113+
feeAddress: feeAddress,
114+
baseAddress: baseAddress
115+
}
116+
};
117+
118+
const baseResult = await apiRequest('POST', `/api/v2/${coin}/wallet/${walletId}/iswalletaddress`, baseAddressParams);
119+
console.log(' Result:', baseResult ? '✓ Valid' : '✗ Invalid');
120+
}
121+
122+
main().catch((e) => console.error(e));
123+

0 commit comments

Comments
 (0)