@dfinity/hardware-wallet-cli 0.2.2 → 0.3.0-next-2023-08-28

package/README.md

@@ -4,9 +4,9 @@ A CLI to interact with the Internet Computer App on Ledger Nano S/X devices.
 
 ## Quick Start
 
-* Install `npm >= 6.14`.
-* Install the CLI: `npm install -g @dfinity/hardware-wallet-cli`
-* Run the CLI: `ic-hardware-wallet --help`
+- Install `node >= 18.13.0`.
+- Install the CLI: `npm install -g @dfinity/hardware-wallet-cli`
+- Run the CLI: `ic-hardware-wallet --help`
 
 ## USB connection issues with Ledger Live
 
@@ -27,5 +27,5 @@ To execute a command, you can use `npm run execute -- <args>`.
 
 For example
 
-* The command `ic-hardware-wallet --network https://nnsdapp.dfinity.network icp balance`.
-* Would be `npm run execute -- --network https://nnsdapp.dfinity.network icp balance` for development.
+- The command `ic-hardware-wallet --network https://nnsdapp.dfinity.network icp balance`.
+- Would be `npm run execute -- --network https://nnsdapp.dfinity.network icp balance` for development.

package/dist/index.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+var we=Object.create;var J=Object.defineProperty;var fe=Object.getOwnPropertyDescriptor;var he=Object.getOwnPropertyNames;var be=Object.getPrototypeOf,Ie=Object.prototype.hasOwnProperty;var Pe=(n,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of he(e))!Ie.call(n,i)&&i!==t&&J(n,i,{get:()=>e[i],enumerable:!(r=fe(e,i))||r.enumerable});return n};var D=(n,e,t)=>(t=n!=null?we(be(n)):{},Pe(e||!n||!n.__esModule?J(t,"default",{value:n,enumerable:!0}):t,n));var a=require("commander"),s=require("@dfinity/nns");var b=require("commander"),k=require("@dfinity/nns"),ce=require("@dfinity/principal");var K=require("@dfinity/agent"),z=require("@dfinity/principal"),_=D(require("@zondax/ledger-icp"));function ve(n,e){if(n.byteLength!==e.byteLength)return!1;let t=new Uint8Array(n),r=new Uint8Array(e);for(let i=0;i<t.length;i++)if(t[i]!==r[i])return!1;return!0}var Ne=n=>[...new Uint8Array(n)].map(e=>e.toString(16).padStart(2,"0")).join(""),w=class{static fromRaw(e){return new w(e)}static fromDer(e){return new w(this.derDecode(e))}static derEncode(e){if(e.byteLength!==w.RAW_KEY_LENGTH){let r=e.byteLength;throw new TypeError(`secp256k1 public key must be ${w.RAW_KEY_LENGTH} bytes long (is ${r})`)}return Uint8Array.from([...w.DER_PREFIX,...new Uint8Array(e)]).buffer}static derDecode(e){let t=w.DER_PREFIX.length+w.RAW_KEY_LENGTH;if(e.byteLength!==t){let i=e.byteLength;throw new TypeError(`secp256k1 DER-encoded public key must be ${t} bytes long (is ${i})`)}let r=e.slice(0,w.DER_PREFIX.length);if(!ve(this.derEncode(r),e))throw new TypeError(`secp256k1 DER-encoded public key is invalid. A valid secp256k1 DER-encoded public key must have the following prefix: ${w.DER_PREFIX}`);return r}constructor(e){this.rawKey=e,this.derKey=w.derEncode(e)}toDer(){return this.derKey}toRaw(){return this.rawKey}toHex(){let e=Ne(this.toRaw());if(!e.match("^[0-9a-fA-F]+$"))throw new Error(`${e} is not a hex string.`);if(e.length<130||e.length>150)throw new Error("The key must be >= 130 characters and <= 150 characters.");return e}},E=w;E.RAW_KEY_LENGTH=65,E.DER_PREFIX=Uint8Array.from([48,86,48,16,6,7,42,134,72,206,61,2,1,6,5,43,129,4,0,10,3,66,0]);var $=D(require("@ledgerhq/hw-transport-webhid")),B=D(require("@ledgerhq/hw-transport-node-hid-noevents")),Z=D(require("node-fetch"));global.fetch=Z.default;function Se(n){return K.Cbor.encode({content:n})}var S=class extends K.SignIdentity{constructor(t,r){super();this.derivePath=t;this._publicKey=r;this._neuronStakeFlag=!1}static async create(t="m/44'/223'/0'/0/0"){let[r,i]=await this._connect();try{let c=await this._fetchPublicKeyFromDevice(r,t);return new this(t,c)}finally{i.close()}}static async _connect(){async function t(){if(await $.default.isSupported())return $.default.create();if(await B.default.isSupported())return B.default.create();throw Error()}try{let r=await t();return[new _.default(r),r]}catch(r){throw r.id&&r.id=="NoDeviceFound"?"No Ledger device found. Is the wallet connected and unlocked?":r.message&&r.message.includes("cannot open device with path")?"Cannot connect to Ledger device. Please close all other wallet applications (e.g. Ledger Live) and try again.":`Cannot connect to Ledger Wallet. Either you have other wallet applications open (e.g. Ledger Live), or your browser doesn't support WebHID, which is necessary to communicate with your Ledger hardware wallet.
+
+Supported browsers:
+* Chrome (Desktop) v89+
+* Edge v89+
+* Opera v76+
+
+Error: ${r}`}}static async _fetchPublicKeyFromDevice(t,r){let i=await t.getAddressAndPubKey(r);if(i.returnCode==28161)throw"Please open the Internet Computer app on your wallet and try again.";if(i.returnCode==_.LedgerError.TransactionRejected)throw"Ledger Wallet is locked. Unlock it and try again.";if(i.returnCode==65535)throw"Unable to fetch the public key. Please try again.";let c=i.principalText,o=E.fromRaw(new Uint8Array(i.publicKey));if(c!==z.Principal.selfAuthenticating(new Uint8Array(o.toDer())).toText())throw new Error("Principal returned by device does not match public key.");return o}async showAddressAndPubKeyOnDevice(){this._executeWithApp(async t=>{await t.showAddressAndPubKey(this.derivePath)})}async getVersion(){return this._executeWithApp(async t=>{let r=await t.getVersion();return{major:r.major,minor:r.minor,patch:r.patch}})}getPublicKey(){return this._publicKey}async sign(t){return await this._executeWithApp(async r=>{let i=await r.sign(this.derivePath,Buffer.from(t),this._neuronStakeFlag?1:0);this._neuronStakeFlag=!1;let c=i.signatureRS;if(!c)throw new Error(`A ledger error happened during signature:
+Code: ${i.returnCode}
+Message: ${JSON.stringify(i.errorMessage)}
+`);if(c?.byteLength!==64)throw new Error(`Signature must be 64 bytes long (is ${c.length})`);return Ae(c)})}flagUpcomingStakeNeuron(){this._neuronStakeFlag=!0}async transformRequest(t){let{body:r,...i}=t,c=await this.sign(Se(r));return{...i,body:{content:r,sender_pubkey:this._publicKey.toDer(),sender_sig:c}}}async _executeWithApp(t){let[r,i]=await S._connect();try{let c=await S._fetchPublicKeyFromDevice(r,this.derivePath);if(JSON.stringify(c)!==JSON.stringify(this._publicKey))throw new Error("Found unexpected public key. Are you sure you're using the right wallet?");return await t(r)}finally{i.close()}}};function Ae(n){return n.buffer.slice(n.byteOffset,n.byteOffset+n.byteLength)}var T=require("@dfinity/utils");var H=require("@dfinity/sns"),h="2.2.1",Q=1e4,V=[H.SnsNeuronPermissionType.NEURON_PERMISSION_TYPE_VOTE,H.SnsNeuronPermissionType.NEURON_PERMISSION_TYPE_SUBMIT_PROPOSAL];var ee=require("commander"),ne=require("@dfinity/agent"),I=async({identity:n,minVersion:e})=>{if(!(n instanceof S))return;let{major:t,minor:r,patch:i}=await n.getVersion(),c=`${t}.${r}.${i}`;if((0,T.smallerVersion)({currentVersion:c,minVersion:e}))throw new Error(`Ledger app version ${c} is too old. Please update to ${e} or newer.`)},F=async({identity:n,version:e})=>{if(!(n instanceof S))return!1;let{major:t,minor:r,patch:i}=await n.getVersion(),c=`${t}.${r}.${i}`;return(0,T.smallerVersion)({currentVersion:c,minVersion:e})},te=n=>n.fullNeuron!==void 0?n.fullNeuron.cachedNeuronStake+n.fullNeuron.maturityE8sEquivalent>BigInt(Q):!1;async function re(n){if(n<0||n>255)throw new ee.InvalidArgumentError("Principal path must be between 0 and 255 inclusive.");return S.create(`m/44'/223'/0'/0/${n}`)}async function oe(n,e){let t=new URL(e).host!="ic0.app",r=new ne.HttpAgent({host:e,identity:n});return t&&await r.fetchRootKey(),r}var Ce=n=>n.reduce((e,t)=>`${e}${t.toString(16).padStart(2,"0")}`,""),ie=n=>Ce(Array.from(n)),De=n=>{let e=[];for(let t=0;t<n.length;t+=2){let r=n.substring(t,t+2),i=parseInt(r,16);e.push(i)}return e},ae=n=>({id:(0,T.arrayOfNumberToUint8Array)(De(n))}),se=()=>BigInt(Date.now())*BigInt(1e6);var ue=require("@dfinity/ledger");function f(n){let e=parseInt(n,10);if(isNaN(e))throw new b.InvalidArgumentError("Not a number.");return e}function de(n){let e=parseInt(n,10);if(isNaN(e))throw new b.InvalidArgumentError("Not a number.");if(e<0||e>100)throw new b.InvalidArgumentError("Not a percentage. Try a number between 0 and 100.");return e}function le(n){if(!["true","false"].includes(n))throw new b.InvalidArgumentError("Not a boolean. Try 'true' or 'false'.");return n!=="false"}function m(n){try{return BigInt(n)}catch(e){throw new b.InvalidArgumentError(e.toString())}}function y(n){try{return ce.Principal.fromText(n)}catch(e){throw new b.InvalidArgumentError(e.toString())}}function C(n){try{return ae(n)}catch(e){throw new b.InvalidArgumentError(e.toString())}}function R(n){try{return k.TokenAmount.fromE8s({amount:m(n),token:k.ICPToken})}catch(e){throw new b.InvalidArgumentError(e.toString())}}function G(n){try{return k.AccountIdentifier.fromHex(n)}catch(e){throw new b.InvalidArgumentError(e.toString())}}function W(n){try{return(0,ue.decodeIcrcAccount)(n)}catch(e){throw new b.InvalidArgumentError(e.toString())}}var pe=require("@dfinity/principal");var O=require("@dfinity/agent"),A=require("@dfinity/sns"),q=require("@dfinity/utils"),x=require("@dfinity/ledger"),P=D(require("chalk")),qn=require("node-window-polyfill/register"),j=D(require("node-fetch"));global.fetch=j.default;window.fetch=j.default;var L=new a.Command,v=console.log,Y=60,me=60*Y,X=24*me,ge=365*X+6*me,U=pe.Principal.fromText("ryjl3-tyaaa-aaaaa-aaaba-cai");async function l(){let n=f(L.opts().principal);return re(n)}async function u(n){let e=L.opts().network;return oe(n,e)}async function Ee(n){let e=await l(),r=await A.SnsGovernanceCanister.create({agent:await u(new O.AnonymousIdentity),canisterId:n}).listNeurons({certified:!0,principal:e.getPrincipal()});r.length>0?r.forEach(i=>{let c=(0,q.fromNullable)(i.id);v(c!==void 0?`Neuron ID: ${ie(c.id)}`:"Neuron ID: N/A")}):p("No neurons found.")}async function ke({neuronId:n,principal:e,canisterId:t}){let r=await l();await A.SnsGovernanceCanister.create({agent:await u(r),canisterId:t}).addNeuronPermissions({neuronId:n,principal:e,permissions:V}),p()}async function xe({neuronId:n,principal:e,canisterId:t}){let r=await l();await A.SnsGovernanceCanister.create({agent:await u(r),canisterId:t}).removeNeuronPermissions({neuronId:n,principal:e,permissions:V}),p()}async function Oe({neuronId:n,canisterId:e}){let t=await l();await A.SnsGovernanceCanister.create({agent:await u(t),canisterId:e}).startDissolving(n),p()}async function Te({neuronId:n,canisterId:e}){let t=await l();await A.SnsGovernanceCanister.create({agent:await u(t),canisterId:e}).stopDissolving(n),p()}async function Re({neuronId:n,canisterId:e,amount:t,to:r}){let i=await l();await A.SnsGovernanceCanister.create({agent:await u(i),canisterId:e}).disburse({neuronId:n,amount:t?.toE8s(),toAccount:r}),p()}async function Ke({neuronId:n,canisterId:e,percentageToStake:t}){let r=await l();await A.SnsGovernanceCanister.create({agent:await u(r),canisterId:e}).stakeMaturity({neuronId:n,percentageToStake:t}),p()}async function _e(n=U){let t={owner:(await l()).getPrincipal()},i=await x.IcrcLedgerCanister.create({agent:await u(new O.AnonymousIdentity),canisterId:n??U}).balance(t);p(`Account ${(0,x.encodeIcrcAccount)(t)} has balance ${i} e8s`)}async function Le({canisterId:n=U,amount:e,to:t}){let r=await l(),i=x.IcrcLedgerCanister.create({agent:await u(r),canisterId:n}),o=await x.IcrcLedgerCanister.create({agent:await u(new O.AnonymousIdentity),canisterId:n}).transactionFee({});await i.transfer({to:{owner:t.owner,subaccount:(0,q.toNullable)(t.subaccount)},amount:e.toE8s(),fee:o,created_at_time:se()}),p()}async function qe(){let n=await l(),e=s.AccountIdentifier.fromPrincipal({principal:n.getPrincipal()}),r=await s.LedgerCanister.create({agent:await u(new O.AnonymousIdentity),hardwareWallet:!0}).accountBalance({accountIdentifier:e});p(`Account ${e.toHex()} has balance ${r} e8s`)}async function $e(n,e){let t=await l(),i=await s.LedgerCanister.create({agent:await u(t),hardwareWallet:!0}).transfer({to:n,amount:e.toE8s(),memo:BigInt(0)});p(`Transaction completed at block height ${i}.`)}async function Be(n){let e=await l(),t=s.AccountIdentifier.fromPrincipal({principal:e.getPrincipal()}),r=e.getPublicKey();v(P.default.bold("Principal: ")+e.getPrincipal()),v(P.default.bold(`Address (${e.derivePath}): `)+t.toHex()),v(P.default.bold("Public key: ")+r.toHex()),n&&(v("Displaying the principal and the address on the device..."),await e.showAddressAndPubKeyOnDevice())}async function He(n){let e=await l(),t=s.LedgerCanister.create({agent:await u(e)}),r=s.GovernanceCanister.create({agent:await u(new O.AnonymousIdentity),hardwareWallet:!0});e.flagUpcomingStakeNeuron();try{let i=await r.stakeNeuron({stake:n.toE8s(),principal:e.getPrincipal(),ledgerCanister:t});p(`Staked neuron with ID: ${i}`)}catch(i){i instanceof s.InsufficientAmountError?M(`Cannot stake less than ${i.minimumAmount} e8s`):i instanceof s.InsufficientFundsError?M(`Your account has insufficient funds (${i.balance} e8s)`):console.log(i)}}async function Ve(n,e,t,r,i){let c=await l(),o=s.GovernanceCanister.create({agent:await u(c)}),g=e*ge+t*X+r*Y+i;await o.increaseDissolveDelay({neuronId:n,additionalDissolveDelaySeconds:g}),p()}async function Fe(n,e,t,r,i){let c=await l();await I({identity:c,minVersion:h});let o=s.GovernanceCanister.create({agent:await u(c)}),g=e*ge+t*X+r*Y+i;await o.setDissolveDelay({neuronId:n,dissolveDelaySeconds:Math.floor(Date.now()/1e3)+g}),p()}async function Ge(n,e,t){let r=await l();await s.GovernanceCanister.create({agent:await u(r),hardwareWallet:!0}).disburse({neuronId:BigInt(n),toAccountId:e,amount:t}),p()}async function We(n,e){let t=await l();await I({identity:t,minVersion:h}),await s.GovernanceCanister.create({agent:await u(t)}).splitNeuron({neuronId:BigInt(n),amount:e}),p()}async function Ue(n,e,t){let r=await l();t!==void 0&&await I({identity:r,minVersion:h});let c=await s.GovernanceCanister.create({agent:await u(r),hardwareWallet:t===void 0&&await F({identity:r,version:h})}).spawnNeuron({neuronId:BigInt(n),newController:e,percentageToSpawn:t});p(`Spawned neuron with ID ${c}`)}async function Me(n,e){let t=await l();await I({identity:t,minVersion:h}),await s.GovernanceCanister.create({agent:await u(t)}).stakeMaturity({neuronId:BigInt(n),percentageToStake:e}),p()}async function je(n,e){let t=await l();await I({identity:t,minVersion:h}),await s.GovernanceCanister.create({agent:await u(t)}).autoStakeMaturity({neuronId:BigInt(n),autoStake:e}),p()}async function Ye(n){let e=await l();await s.GovernanceCanister.create({agent:await u(e)}).startDissolving(n),p()}async function Xe(n){let e=await l();await s.GovernanceCanister.create({agent:await u(e)}).stopDissolving(n),p()}async function Je(n){let e=await l();await I({identity:e,minVersion:h}),await s.GovernanceCanister.create({agent:await u(e),hardwareWallet:!0}).joinCommunityFund(n),p()}async function ze(n){let e=await l();await I({identity:e,minVersion:h}),await s.GovernanceCanister.create({agent:await u(e),hardwareWallet:!0}).leaveCommunityFund(n),p()}async function Ze(n,e){let t=await l();await s.GovernanceCanister.create({agent:await u(t),hardwareWallet:!0}).addHotkey({neuronId:BigInt(n),principal:e}),p()}async function Qe(n,e){let t=await l();await s.GovernanceCanister.create({agent:await u(t),hardwareWallet:!0}).removeHotkey({neuronId:BigInt(n),principal:e}),p()}async function en(n=!1){let e=await l(),r=await s.GovernanceCanister.create({agent:await u(e),hardwareWallet:await F({identity:e,version:"2.0.0"})}).listNeurons({certified:!0});r.length>0?r.filter(i=>n||te(i)).forEach(i=>{v(`Neuron ID: ${i.neuronId}`)}):p("No neurons found.")}async function nn(n,e){let t=await l();await I({identity:t,minVersion:h}),await s.GovernanceCanister.create({agent:await u(t)}).mergeNeurons({targetNeuronId:e,sourceNeuronId:n}),p()}async function tn(n){let e=await l();await I({identity:e,minVersion:h}),await s.GovernanceCanister.create({agent:await u(e)}).setNodeProviderAccount(n.toHex()),p()}async function rn(){let n=await l(),t=n.getPublicKey().toHex(),i=await(await s.GenesisTokenCanister.create({agent:await u(n)})).claimNeurons({hexPubKey:t});p(`Successfully claimed the following neurons: ${i}`)}async function d(n){try{await n()}catch(e){M(e)}}function p(n){v(n?`${P.default.green(P.default.bold("OK"))}: ${n}`:`${P.default.green(P.default.bold("OK"))}`)}function M(n){let e=n instanceof s.GovernanceError?n.detail.error_message:n instanceof Error?n.message:n;v(`${P.default.bold(P.default.red("Error:"))} ${e}`)}async function on(){let n=new a.Command("icrc").description("Commands for managing ICRC ledger.").addCommand(new a.Command("balance").description("Get the balance of the main account on the ICRC wallet.").option("--canister-id <canister-id>","Canister ID (defaults to ICP Ledger)",y).action(o=>d(()=>_e(o.canisterId)))).addCommand(new a.Command("transfer").description("Send tokens from the ICRC wallet to another account.").option("--canister-id <canister-id>","Canister ID (defaults to ICP Ledger)",y).requiredOption("--to <account-identifier>","ICRC Account",W).requiredOption("--amount <amount>","Amount to transfer in e8s",R).action(({to:o,amount:g,canisterId:N})=>{d(()=>Le({to:o,amount:g,canisterId:N}))})),e=new a.Command("neuron").description("Commands for managing sns neurons.").addCommand(new a.Command("list").requiredOption("--canister-id <canister-id>","Canister ID",y).action(o=>d(()=>Ee(o.canisterId)))).addCommand(new a.Command("add-hotkey").requiredOption("--canister-id <canister-id>","Canister ID",y).requiredOption("--principal <principal>","Principal",y).requiredOption("--neuron-id <neuron-id>","Neuron ID",C).action(({canisterId:o,principal:g,neuronId:N})=>d(()=>ke({canisterId:o,principal:g,neuronId:N})))).addCommand(new a.Command("remove-hotkey").requiredOption("--canister-id <canister-id>","Canister ID",y).requiredOption("--principal <principal>","Principal",y).requiredOption("--neuron-id <neuron-id>","Neuron ID",C).action(({canisterId:o,principal:g,neuronId:N})=>d(()=>xe({canisterId:o,principal:g,neuronId:N})))).addCommand(new a.Command("start-dissolving").requiredOption("--canister-id <canister-id>","Canister ID",y).requiredOption("--neuron-id <neuron-id>","Neuron ID",C).action(({canisterId:o,neuronId:g})=>d(()=>Oe({canisterId:o,neuronId:g})))).addCommand(new a.Command("stop-dissolving").requiredOption("--canister-id <canister-id>","Canister ID",y).requiredOption("--neuron-id <neuron-id>","Neuron ID",C).action(({canisterId:o,neuronId:g})=>d(()=>Te({canisterId:o,neuronId:g})))).addCommand(new a.Command("stake-maturity").requiredOption("--canister-id <canister-id>","Canister ID",y).requiredOption("--neuron-id <neuron-id>","Neuron ID",C).option("--percentage <percentage>","Percentage of the maturity to stake (defaults to 100)",de).action(({canisterId:o,neuronId:g,percentage:N})=>d(()=>Ke({canisterId:o,neuronId:g,percentageToStake:N})))).addCommand(new a.Command("disburse").requiredOption("--canister-id <canister-id>","Canister ID",y).requiredOption("--neuron-id <neuron-id>","Neuron ID",C).option("--to <account-identifier>","ICRC Account (defaults to controller's main account)",W).option("--amount <amount>","Amount to disburse in e8s (empty to disburse all)",R).action(({neuronId:o,to:g,amount:N,canisterId:ye})=>{d(()=>Re({neuronId:o,to:g,amount:N,canisterId:ye}))})),t=new a.Command("sns").description("Commands for managing SNS.").addCommand(e),r=new a.Command("neuron").description("Commands for managing neurons.").showSuggestionAfterError().addCommand(new a.Command("stake").requiredOption("--amount <amount>","Amount to stake in e8s.",R).action(o=>d(()=>He(o.amount)))).addCommand(new a.Command("increase-dissolve-delay").requiredOption("--neuron-id <neuron-id>","Neuron ID",m).option("--years <years>","Number of years",f).option("--days <days>","Number of days",f).option("--minutes <minutes>","Number of minutes",f).option("--seconds <seconds>","Number of seconds",f).action(o=>d(()=>Ve(o.neuronId,o.years||0,o.days||0,o.minutes||0,o.seconds||0)))).addCommand(new a.Command("set-dissolve-delay").requiredOption("--neuron-id <neuron-id>","Neuron ID",m).option("--years <years>","Number of years",f).option("--days <days>","Number of days",f).option("--minutes <minutes>","Number of minutes",f).option("--seconds <seconds>","Number of seconds",f).action(o=>d(()=>Fe(o.neuronId,o.years||0,o.days||0,o.minutes||0,o.seconds||0)))).addCommand(new a.Command("disburse").requiredOption("--neuron-id <neuron-id>","Neuron ID",m).option("--to <account-identifier>").option("--amount <amount>","Amount to disburse in e8s (empty to disburse all)",m).action(o=>{d(()=>Ge(o.neuronId,o.to,o.amount))})).addCommand(new a.Command("split").requiredOption("--neuron-id <neuron-id>","Neuron ID",m).option("--amount <amount>","Amount split into a new neuron in e8s",m).action(o=>{d(()=>We(o.neuronId,o.amount))})).addCommand(new a.Command("spawn").requiredOption("--neuron-id <neuron-id>","Neuron ID",m).option("--controller <new-controller>","Controller",y).option("--percentage-to-spawn <percentage>","Percentage of maturity to spawn",f).action(o=>{d(()=>Ue(o.neuronId,o.controller,o.percentageToSpawn))})).addCommand(new a.Command("stake-maturity").requiredOption("--neuron-id <neuron-id>","Neuron ID",m).option("--percentage-to-stake <percentage>","Percentage of maturity to stake",f).action(o=>{d(()=>Me(o.neuronId,o.percentageToStake))})).addCommand(new a.Command("enable-auto-stake-maturity").requiredOption("--neuron-id <neuron-id>","Neuron ID",m).requiredOption("--enable-auto-stake <enable>","Should auto stake maturity be enabled",le).action(o=>{d(()=>je(o.neuronId,o.enableAutoStake))})).addCommand(new a.Command("start-dissolving").requiredOption("--neuron-id <neuron-id>","Neuron ID",m).action(o=>{d(()=>Ye(o.neuronId))})).addCommand(new a.Command("stop-dissolving").requiredOption("--neuron-id <neuron-id>","Neuron ID",m).action(o=>{d(()=>Xe(o.neuronId))})).addCommand(new a.Command("join-community-fund").requiredOption("--neuron-id <neuron-id>","Neuron ID",m).action(o=>{d(()=>Je(o.neuronId))})).addCommand(new a.Command("leave-community-fund").requiredOption("--neuron-id <neuron-id>","Neuron ID",m).action(o=>{d(()=>ze(o.neuronId))})).addCommand(new a.Command("list").option("--show-zero-stake","Show neurons with zero stake and maturity").action(o=>d(()=>en(o.showZeroStake)))).addCommand(new a.Command("add-hotkey").requiredOption("--neuron-id <neuron-id>","Neuron ID",m).requiredOption("--principal <principal>","Principal",y).action(o=>d(()=>Ze(o.neuronId,o.principal)))).addCommand(new a.Command("merge-neurons").requiredOption("--source-neuron-id <source-neuron-id>","Neuron ID",m).requiredOption("--target-neuron-id <target-neuron-id>","Neuron ID",m).action(o=>d(()=>nn(o.sourceNeuronId,o.targetNeuronId)))).addCommand(new a.Command("remove-hotkey").requiredOption("--neuron-id <neuron-id>","Neuron ID",m).requiredOption("--principal <principal>","Principal",y).action(o=>d(()=>Qe(o.neuronId,o.principal)))).addCommand(new a.Command("claim").description("Claim the caller's GTC neurons.").action(o=>d(()=>rn()))),i=new a.Command("icp").description("Commands for managing ICP.").showSuggestionAfterError().addCommand(new a.Command("balance").description("Fetch current balance.").action(()=>{d(qe)})).addCommand(new a.Command("transfer").requiredOption("--to <account-identifier>","Account identifier to transfer to.",G).requiredOption("--amount <amount>","Amount to transfer in e8s.",R).action(o=>d(()=>$e(o.to,o.amount)))),c=new a.Command("node-provider").description("Commands for managing node providers.").showSuggestionAfterError().addCommand(new a.Command("set-node-provider-account").requiredOption("--account <account>","Account ID",G).action(o=>d(()=>tn(o.account))));L.description("A CLI for the Ledger hardware wallet.").enablePositionalOptions().showSuggestionAfterError().addOption(new a.Option("--network <network>","The IC network to talk to.").default("https://ic0.app").env("IC_NETWORK")).addOption(new a.Option("--principal <principal>",`The derivation path to use for the principal.
+(e.g. --principal 123 will result in a derivation path of m/44'/223'/0'/0/123)
+Must be >= 0 && <= 255`).default(0)).addCommand(new a.Command("info").option("-n --no-show-on-device").description("Show the wallet's principal, address, and balance.").action(o=>{d(()=>Be(o.showOnDevice))})).addCommand(i).addCommand(r).addCommand(t).addCommand(n).addCommand(c),await L.parseAsync(process.argv)}on();

package/package.json

@@ -1,17 +1,26 @@
 {
   "name": "@dfinity/hardware-wallet-cli",
-  "version": "0.2.2",
   "description": "A CLI to interact with the Internet Computer App on Ledger Nano S/X devices.",
-  "main": "./build/index.js",
+  "main": "./dist/index.js",
+  "files": [
+    "dist/index.js",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "format": "prettier --write .",
     "test": "echo \"Error: no test specified\" && exit 1",
-    "build": "tsc --build",
+    "build": "node rmdir.mjs && node esbuild.mjs",
     "prepack": "npm run build",
-    "clean": "tsc --build --clean",
+    "clean": "npm run build",
     "refresh": "rm -rf ./node_modules ./package-lock.json && npm install",
-    "execute": "ts-node ./index.ts",
-    "update:nns": "npm update @dfinity/nns"
+    "execute": "ts-node ./src/index.ts",
+    "update:next": "npm update @dfinity/nns @dfinity/sns @dfinity/utils",
+    "update:agent": "npm rm @dfinity/agent @dfinity/principal && npm i @dfinity/agent @dfinity/principal"
+  },
+  "engineStrict": true,
+  "engines": {
+    "node": ">= 18.13.0"
   },
   "repository": {
     "type": "git",
@@ -24,24 +33,35 @@
   },
   "homepage": "https://github.com/dfinity/hardware-wallet-cli#readme",
   "dependencies": {
-    "@dfinity/agent": "^0.11.2",
-    "@dfinity/nns": "nightly",
+    "@dfinity/agent": "^0.15.2",
+    "@dfinity/ledger": "next",
+    "@dfinity/nns": "next",
+    "@dfinity/principal": "^0.15.2",
+    "@dfinity/sns": "next",
+    "@dfinity/utils": "next",
     "@ledgerhq/hw-transport-node-hid-noevents": "^6.3.0",
     "@ledgerhq/hw-transport-webhid": "^6.27.1",
     "@zondax/ledger-icp": "^0.6.0",
+    "buffer": "^6.0.3",
     "chalk": "^4.1.2",
     "commander": "^9.0.0",
     "node-fetch": "^2.6.1",
     "node-window-polyfill": "^1.0.2"
   },
   "devDependencies": {
+    "@esbuild-plugins/node-resolve": "^0.2.0",
     "@types/google-protobuf": "^3.15.6",
     "@types/node": "^17.0.16",
     "@types/node-hid": "^1.3.1",
+    "esbuild": "^0.17.4",
     "prettier": "^2.6.2",
-    "ts-node": "^10.8.0"
+    "ts-node": "^10.9.1"
   },
   "bin": {
-    "ic-hardware-wallet": "./build/index.js"
-  }
-}
+    "ic-hardware-wallet": "./dist/index.js"
+  },
+  "overrides": {
+    "semver": "^7.5.3"
+  },
+  "version": "0.3.0-next-2023-08-28"
+}

package/.github/CODEOWNERS

@@ -1,2 +0,0 @@
-# The codebase is owned by the Governance & Identity Experience team at DFINITY
-# For questions, reach out to: <gix@dfinity.org>

package/.prettierignore

@@ -1 +0,0 @@
-build

package/build/index.js

@@ -1,401 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * A CLI tool for testing the Ledger hardware wallet integration.
- */
-const commander_1 = require("commander");
-const identity_1 = require("./src/ledger/identity");
-const nns_1 = require("@dfinity/nns");
-const principal_1 = require("@dfinity/principal");
-const agent_1 = require("@dfinity/agent");
-const chalk_1 = __importDefault(require("chalk"));
-// Add polyfill for `window` for `TransportWebHID` checks to work.
-require("node-window-polyfill/register");
-// Add polyfill for `window.fetch` for agent-js to work.
-// @ts-ignore (no types are available)
-const node_fetch_1 = __importDefault(require("node-fetch"));
-global.fetch = node_fetch_1.default;
-window.fetch = node_fetch_1.default;
-const program = new commander_1.Command();
-const log = console.log;
-const SECONDS_PER_MINUTE = 60;
-const SECONDS_PER_HOUR = 60 * SECONDS_PER_MINUTE;
-const SECONDS_PER_DAY = 24 * SECONDS_PER_HOUR;
-const SECONDS_PER_YEAR = 365 * SECONDS_PER_DAY + 6 * SECONDS_PER_HOUR;
-async function getAgent(identity) {
-    const network = program.opts().network;
-    // Only fetch the rootkey if the network isn't mainnet.
-    const fetchRootKey = new URL(network).host == "ic0.app" ? false : true;
-    const agent = new agent_1.HttpAgent({
-        host: program.opts().network,
-        identity: identity,
-    });
-    if (fetchRootKey) {
-        await agent.fetchRootKey();
-    }
-    return agent;
-}
-async function getLedgerIdentity() {
-    const principalPath = tryParseInt(program.opts().principal);
-    if (principalPath < 0 || principalPath > 255) {
-        throw new commander_1.InvalidArgumentError("Principal path must be between 0 and 255 inclusive.");
-    }
-    return identity_1.LedgerIdentity.create(`m/44'/223'/0'/0/${principalPath}`);
-}
-/**
- * Fetches the balance of the main account on the wallet.
- */
-async function getBalance() {
-    const identity = await getLedgerIdentity();
-    const accountIdentifier = nns_1.AccountIdentifier.fromPrincipal({
-        principal: identity.getPrincipal(),
-    });
-    const ledger = nns_1.LedgerCanister.create({
-        agent: await getAgent(new agent_1.AnonymousIdentity()),
-        hardwareWallet: true,
-    });
-    const balance = await ledger.accountBalance({
-        accountIdentifier: accountIdentifier,
-    });
-    ok(`Account ${accountIdentifier.toHex()} has balance ${balance.toE8s()} e8s`);
-}
-/**
- * Send ICP to another address.
- *
- * @param to The account identifier in hex.
- * @param amount Amount to send in e8s.
- */
-async function sendICP(to, amount) {
-    const identity = await getLedgerIdentity();
-    const ledger = nns_1.LedgerCanister.create({
-        agent: await getAgent(identity),
-        hardwareWallet: true,
-    });
-    const blockHeight = await ledger.transfer({
-        to: to,
-        amount: amount,
-        memo: BigInt(0),
-    });
-    ok(`Transaction completed at block height ${blockHeight}.`);
-}
-/**
- * Shows the principal and account idenifier on the terminal and on the wallet's screen.
- */
-async function showInfo(showOnDevice) {
-    const identity = await getLedgerIdentity();
-    const accountIdentifier = nns_1.AccountIdentifier.fromPrincipal({
-        principal: identity.getPrincipal(),
-    });
-    const publicKey = identity.getPublicKey();
-    log(chalk_1.default.bold(`Principal: `) + identity.getPrincipal());
-    log(chalk_1.default.bold(`Address (${identity.derivePath}): `) + accountIdentifier.toHex());
-    log(chalk_1.default.bold('Public key: ') + publicKey.toHex());
-    if (showOnDevice) {
-        log("Displaying the principal and the address on the device...");
-        await identity.showAddressAndPubKeyOnDevice();
-    }
-}
-/**
- * Stakes a new neuron.
- *
- * @param amount Amount to stake in e8s.
- */
-async function stakeNeuron(stake) {
-    const identity = await getLedgerIdentity();
-    const ledger = nns_1.LedgerCanister.create({
-        agent: await getAgent(identity),
-    });
-    const governance = nns_1.GovernanceCanister.create({
-        agent: await getAgent(new agent_1.AnonymousIdentity()),
-        hardwareWallet: true,
-    });
-    // Flag that an upcoming stake neuron transaction is coming to distinguish
-    // it from a "send ICP" transaction on the device.
-    identity.flagUpcomingStakeNeuron();
-    try {
-        const stakedNeuronId = await governance.stakeNeuron({
-            stake: stake,
-            principal: identity.getPrincipal(),
-            ledgerCanister: ledger,
-        });
-        ok(`Staked neuron with ID: ${stakedNeuronId}`);
-    }
-    catch (error) {
-        if (error instanceof nns_1.InsufficientAmountError) {
-            err(`Cannot stake less than ${error.minimumAmount.toE8s()} e8s`);
-        }
-        else if (error instanceof nns_1.InsufficientFundsError) {
-            err(`Your account has insufficient funds (${error.balance.toE8s()} e8s)`);
-        }
-        else {
-            console.log(error);
-        }
-    }
-}
-async function increaseDissolveDelay(neuronId, years, days, minutes, seconds) {
-    const identity = await getLedgerIdentity();
-    const governance = nns_1.GovernanceCanister.create({
-        agent: await getAgent(identity),
-        hardwareWallet: true,
-    });
-    const additionalDissolveDelaySeconds = years * SECONDS_PER_YEAR +
-        days * SECONDS_PER_DAY +
-        minutes * SECONDS_PER_MINUTE +
-        seconds;
-    await governance.increaseDissolveDelay({
-        neuronId: neuronId,
-        additionalDissolveDelaySeconds: additionalDissolveDelaySeconds,
-    });
-    ok();
-}
-async function disburseNeuron(neuronId, to, amount) {
-    const identity = await getLedgerIdentity();
-    const governance = nns_1.GovernanceCanister.create({
-        agent: await getAgent(identity),
-        hardwareWallet: true,
-    });
-    await governance.disburse({
-        neuronId: BigInt(neuronId),
-        toAccountId: to,
-        amount: amount,
-    });
-    ok();
-}
-async function spawnNeuron(neuronId, controller) {
-    const identity = await getLedgerIdentity();
-    const governance = nns_1.GovernanceCanister.create({
-        agent: await getAgent(identity),
-        hardwareWallet: true,
-    });
-    const spawnedNeuronId = await governance.spawnNeuron({
-        neuronId: BigInt(neuronId),
-        newController: controller,
-    });
-    ok(`Spawned neuron with ID ${spawnedNeuronId}`);
-}
-async function startDissolving(neuronId) {
-    const identity = await getLedgerIdentity();
-    const governance = nns_1.GovernanceCanister.create({
-        agent: await getAgent(identity),
-        hardwareWallet: true,
-    });
-    await governance.startDissolving(neuronId);
-    ok();
-}
-async function stopDissolving(neuronId) {
-    const identity = await getLedgerIdentity();
-    const governance = nns_1.GovernanceCanister.create({
-        agent: await getAgent(identity),
-        hardwareWallet: true,
-    });
-    await governance.stopDissolving(neuronId);
-    ok();
-}
-async function addHotkey(neuronId, principal) {
-    const identity = await getLedgerIdentity();
-    const governance = nns_1.GovernanceCanister.create({
-        agent: await getAgent(identity),
-        hardwareWallet: true,
-    });
-    await governance.addHotkey({
-        neuronId: BigInt(neuronId),
-        principal: principal,
-    });
-    ok();
-}
-async function removeHotkey(neuronId, principal) {
-    const identity = await getLedgerIdentity();
-    const governance = nns_1.GovernanceCanister.create({
-        agent: await getAgent(identity),
-        hardwareWallet: true,
-    });
-    await governance.removeHotkey({
-        neuronId: BigInt(neuronId),
-        principal: principal,
-    });
-    ok();
-}
-async function listNeurons() {
-    const identity = await getLedgerIdentity();
-    const governance = nns_1.GovernanceCanister.create({
-        agent: await getAgent(identity),
-        hardwareWallet: true,
-    });
-    // We filter neurons with no ICP, as they'll be garbage collected by the governance canister.
-    const neurons = await governance.listNeurons({
-        certified: true,
-    });
-    if (neurons.length > 0) {
-        neurons.forEach((n) => {
-            log(`Neuron ID: ${n.neuronId}`);
-        });
-    }
-    else {
-        ok("No neurons found.");
-    }
-}
-/**
- * Fetches the balance of the main account on the wallet.
- */
-async function claimNeurons() {
-    const identity = await getLedgerIdentity();
-    const publicKey = identity.getPublicKey();
-    const hexPubKey = publicKey.toHex();
-    const governance = await nns_1.GenesisTokenCanister.create({
-        agent: await getAgent(identity),
-    });
-    const claimedNeuronIds = await governance.claimNeurons({
-        hexPubKey,
-    });
-    ok(`Successfully claimed the following neurons: ${claimedNeuronIds}`);
-}
-/**
- * Runs a function with a try/catch block.
- */
-async function run(f) {
-    try {
-        await f();
-    }
-    catch (error) {
-        err(error);
-    }
-}
-function ok(message) {
-    if (message) {
-        log(`${chalk_1.default.green(chalk_1.default.bold("OK"))}: ${message}`);
-    }
-    else {
-        log(`${chalk_1.default.green(chalk_1.default.bold("OK"))}`);
-    }
-}
-function err(error) {
-    const message = error instanceof nns_1.GovernanceError
-        ? error.detail.error_message
-        : error instanceof Error
-            ? error.message
-            : error;
-    log(`${chalk_1.default.bold(chalk_1.default.red("Error:"))} ${message}`);
-}
-function tryParseInt(value) {
-    const parsedValue = parseInt(value, 10);
-    if (isNaN(parsedValue)) {
-        throw new commander_1.InvalidArgumentError("Not a number.");
-    }
-    return parsedValue;
-}
-function tryParseBigInt(value) {
-    try {
-        return BigInt(value);
-    }
-    catch (err) {
-        throw new commander_1.InvalidArgumentError(err.toString());
-    }
-}
-function tryParsePrincipal(value) {
-    try {
-        return principal_1.Principal.fromText(value);
-    }
-    catch (err) {
-        throw new commander_1.InvalidArgumentError(err.toString());
-    }
-}
-function tryParseE8s(e8s) {
-    try {
-        return nns_1.ICP.fromE8s(tryParseBigInt(e8s));
-    }
-    catch (err) {
-        throw new commander_1.InvalidArgumentError(err.toString());
-    }
-}
-function tryParseAccountIdentifier(accountIdentifier) {
-    try {
-        return nns_1.AccountIdentifier.fromHex(accountIdentifier);
-    }
-    catch (err) {
-        throw new commander_1.InvalidArgumentError(err.toString());
-    }
-}
-async function main() {
-    const neuron = new commander_1.Command("neuron")
-        .description("Commands for managing neurons.")
-        .showSuggestionAfterError()
-        .addCommand(new commander_1.Command("stake")
-        .requiredOption("--amount <amount>", "Amount to stake in e8s.", tryParseE8s)
-        .action((args) => run(() => stakeNeuron(args.amount))))
-        .addCommand(new commander_1.Command("increase-dissolve-delay")
-        .requiredOption("--neuron-id <neuron-id>", "Neuron ID", tryParseBigInt)
-        .option("--years <years>", "Number of years", tryParseInt)
-        .option("--days <days>", "Number of days", tryParseInt)
-        .option("--minutes <minutes>", "Number of minutes", tryParseInt)
-        .option("--seconds <seconds>", "Number of seconds", tryParseInt)
-        .action((args) => run(() => increaseDissolveDelay(args.neuronId, args.years || 0, args.days || 0, args.minutes || 0, args.seconds || 0))))
-        .addCommand(new commander_1.Command("disburse")
-        .requiredOption("--neuron-id <neuron-id>", "Neuron ID", tryParseBigInt)
-        .option("--to <account-identifier>")
-        .option("--amount <amount>", "Amount to disburse (empty to disburse all)", tryParseBigInt)
-        .action((args) => {
-        run(() => disburseNeuron(args.neuronId, args.to, args.amount));
-    }))
-        .addCommand(new commander_1.Command("spawn")
-        .requiredOption("--neuron-id <neuron-id>", "Neuron ID", tryParseBigInt)
-        .option("--controller <new-controller>", "Controller", tryParsePrincipal)
-        .action((args) => {
-        run(() => spawnNeuron(args.neuronId, args.controller));
-    }))
-        .addCommand(new commander_1.Command("start-dissolving")
-        .requiredOption("--neuron-id <neuron-id>", "Neuron ID", tryParseBigInt)
-        .action((args) => {
-        run(() => startDissolving(args.neuronId));
-    }))
-        .addCommand(new commander_1.Command("stop-dissolving")
-        .requiredOption("--neuron-id <neuron-id>", "Neuron ID", tryParseBigInt)
-        .action((args) => {
-        run(() => stopDissolving(args.neuronId));
-    }))
-        .addCommand(new commander_1.Command("list").action(() => run(listNeurons)))
-        .addCommand(new commander_1.Command("add-hotkey")
-        .requiredOption("--neuron-id <neuron-id>", "Neuron ID", tryParseBigInt)
-        .requiredOption("--principal <principal>", "Principal", tryParsePrincipal)
-        .action((args) => run(() => addHotkey(args.neuronId, args.principal))))
-        .addCommand(new commander_1.Command("remove-hotkey")
-        .requiredOption("--neuron-id <neuron-id>", "Neuron ID", tryParseBigInt)
-        .requiredOption("--principal <principal>", "Principal", tryParsePrincipal)
-        .action((args) => run(() => removeHotkey(args.neuronId, args.principal))))
-        .addCommand(new commander_1.Command("claim")
-        .description("Claim the caller's GTC neurons.")
-        .action((args) => run(() => claimNeurons())));
-    const icp = new commander_1.Command("icp")
-        .description("Commands for managing ICP.")
-        .showSuggestionAfterError()
-        .addCommand(new commander_1.Command("balance")
-        .description("Fetch current balance.")
-        .action(() => {
-        run(getBalance);
-    }))
-        .addCommand(new commander_1.Command("transfer")
-        .requiredOption("--to <account-identifier>", "Account identifier to transfer to.", tryParseAccountIdentifier)
-        .requiredOption("--amount <amount>", "Amount to transfer in e8s.", tryParseE8s)
-        .action((args) => run(() => sendICP(args.to, args.amount))));
-    program
-        .description("A CLI for the Ledger hardware wallet.")
-        .enablePositionalOptions()
-        .showSuggestionAfterError()
-        .addOption(new commander_1.Option("--network <network>", "The IC network to talk to.")
-        .default("https://ic0.app")
-        .env("IC_NETWORK"))
-        .addOption(new commander_1.Option("--principal <principal>", "The derivation path to use for the principal.\n(e.g. --principal 123 will result in a derivation path of m/44'/223'/0'/0/123)\nMust be >= 0 && <= 255").default(0))
-        .addCommand(new commander_1.Command("info")
-        .option("-n --no-show-on-device")
-        .description("Show the wallet's principal, address, and balance.")
-        .action((args) => {
-        run(() => showInfo(args.showOnDevice));
-    }))
-        .addCommand(icp)
-        .addCommand(neuron);
-    await program.parseAsync(process.argv);
-}
-main();