@alephium/web3 0.2.0-rc.8 → 0.2.0-test.1

package/src/contract/ralph.test.ts

@@ -0,0 +1,178 @@
+/*
+Copyright 2018 - 2022 The Alephium Authors
+This file is part of the alephium project.
+
+The library is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+The library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with the library. If not, see <http://www.gnu.org/licenses/>.
+*/
+
+import { node } from '../api'
+import * as ralph from './ralph'
+import * as utils from '../utils'
+import { Fields } from './contract'
+
+describe('contract', function () {
+  it('should encode I256', async () => {
+    function test(i256: bigint, expected: string) {
+      expect(utils.binToHex(ralph.encodeI256(i256))).toEqual(expected)
+    }
+    test(BigInt('0'), '00')
+    test(BigInt('1'), '01')
+    test(BigInt('2'), '02')
+    test(BigInt('-1'), '3f')
+    test(BigInt('-2'), '3e')
+    test(BigInt('32'), '4020')
+    test(BigInt('33'), '4021')
+    test(BigInt('34'), '4022')
+    test(BigInt('31'), '1f')
+    test(BigInt('30'), '1e')
+    test(BigInt('8192'), '80002000')
+    test(BigInt('8193'), '80002001')
+    test(BigInt('8194'), '80002002')
+    test(BigInt('8191'), '5fff')
+    test(BigInt('8190'), '5ffe')
+    test(BigInt('536870912'), 'c020000000')
+    test(BigInt('536870913'), 'c020000001')
+    test(BigInt('536870914'), 'c020000002')
+    test(BigInt('536870911'), '9fffffff')
+    test(BigInt('536870910'), '9ffffffe')
+    test(
+      BigInt('57896044618658097711785492504343953926634992332820282019728792003956564819967'),
+      'dc7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff'
+    )
+    test(
+      BigInt('57896044618658097711785492504343953926634992332820282019728792003956564819966'),
+      'dc7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe'
+    )
+    test(
+      BigInt('57896044618658097711785492504343953926634992332820282019728792003956564819965'),
+      'dc7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffd'
+    )
+    test(
+      BigInt('-57896044618658097711785492504343953926634992332820282019728792003956564819968'),
+      'dc8000000000000000000000000000000000000000000000000000000000000000'
+    )
+    test(
+      BigInt('-57896044618658097711785492504343953926634992332820282019728792003956564819967'),
+      'dc8000000000000000000000000000000000000000000000000000000000000001'
+    )
+    test(
+      BigInt('-57896044618658097711785492504343953926634992332820282019728792003956564819966'),
+      'dc8000000000000000000000000000000000000000000000000000000000000002'
+    )
+
+    function fail(n: bigint) {
+      expect(() => ralph.encodeI256(n)).toThrow()
+    }
+    fail(BigInt('57896044618658097711785492504343953926634992332820282019728792003956564819968'))
+    fail(BigInt('57896044618658097711785492504343953926634992332820282019728792003956564819969'))
+    fail(BigInt('-57896044618658097711785492504343953926634992332820282019728792003956564819969'))
+    fail(BigInt('-57896044618658097711785492504343953926634992332820282019728792003956564819970'))
+  })
+
+  it('should encode U256', async () => {
+    function test(u256: bigint, expected: string) {
+      expect(utils.binToHex(ralph.encodeU256(u256))).toEqual(expected)
+    }
+    test(BigInt('0'), '00')
+    test(BigInt('1'), '01')
+    test(BigInt('2'), '02')
+    fail(BigInt('-1'))
+    fail(BigInt('-2'))
+    test(BigInt('64'), '4040')
+    test(BigInt('65'), '4041')
+    test(BigInt('66'), '4042')
+    test(BigInt('63'), '3f')
+    test(BigInt('62'), '3e')
+    test(BigInt('16384'), '80004000')
+    test(BigInt('16385'), '80004001')
+    test(BigInt('16386'), '80004002')
+    test(BigInt('16383'), '7fff')
+    test(BigInt('16382'), '7ffe')
+    test(BigInt('1073741824'), 'c040000000')
+    test(BigInt('1073741825'), 'c040000001')
+    test(BigInt('1073741826'), 'c040000002')
+    test(BigInt('1073741823'), 'bfffffff')
+    test(BigInt('1073741822'), 'bffffffe')
+    test(
+      BigInt('115792089237316195423570985008687907853269984665640564039457584007913129639935'),
+      'dcffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff'
+    )
+    test(
+      BigInt('115792089237316195423570985008687907853269984665640564039457584007913129639934'),
+      'dcfffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe'
+    )
+    test(
+      BigInt('115792089237316195423570985008687907853269984665640564039457584007913129639933'),
+      'dcfffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffd'
+    )
+
+    function fail(n: bigint) {
+      expect(() => ralph.encodeU256(n)).toThrow()
+    }
+    fail(BigInt('115792089237316195423570985008687907853269984665640564039457584007913129639936'))
+    fail(BigInt('115792089237316195423570985008687907853269984665640564039457584007913129639937'))
+  })
+
+  it('should encode ByteVec', async () => {
+    const bytes = 'b382fc88aa31d63f4c2f3f8a03715ba2a629552e85431fb1c1d909bab46d1aae'
+    const bytecode = ralph.encodeScriptFieldAsString('ByteVec', bytes)
+    expect(bytecode).toEqual('144020b382fc88aa31d63f4c2f3f8a03715ba2a629552e85431fb1c1d909bab46d1aae')
+  })
+
+  it('should test buildScriptByteCode', async () => {
+    const variables = { x: true, y: 0x05, z: 'ff', a: '1C2RAVWSuaXw8xtUxqVERR7ChKBE1XgscNFw73NSHE1v3' }
+    const fieldsSig: node.FieldsSig = {
+      names: ['x', 'y', 'z', 'a'],
+      types: ['Bool', 'U256', 'ByteVec', 'Address'],
+      isMutable: [false, false, false, false]
+    }
+    const bytecode = ralph.buildScriptByteCode('-{0}-{1}-{2}-{3}-', variables, fieldsSig)
+    expect(bytecode).toEqual('-03-1305-1401ff-1500a3cd757be03c7dac8d48bf79e2a7d6e735e018a9c054b99138c7b29738c437ec-')
+  })
+
+  it('should test buildContractByteCode', async () => {
+    const fields: Fields = {
+      a: -1,
+      b: 1,
+      c: '23',
+      d: '1C2RAVWSuaXw8xtUxqVERR7ChKBE1XgscNFw73NSHE1v3',
+      e: [false, true]
+    }
+    const fieldsSig: node.FieldsSig = {
+      names: ['a', 'b', 'c', 'd', 'e'],
+      types: ['I256', 'U256', 'ByteVec', 'Address', '[Bool;2]'],
+      isMutable: [false, false, false, false]
+    }
+    const encoded = ralph.buildContractByteCode('ff', fields, fieldsSig)
+    expect(encoded).toEqual(
+      'ff06013f02010301230400a3cd757be03c7dac8d48bf79e2a7d6e735e018a9c054b99138c7b29738c437ec00000001'
+    )
+  })
+
+  // it('should test buildByteCode', async () => {
+  //   const compiled = {
+  //     type: 'TemplateContractByteCode',
+  //     filedLength: 1,
+  //     methodsByteCode: [
+  //       '01000203021205160016015f{subContractId:ByteVec}1702a00016002a16012aa100a000160016011602010002',
+  //       '00000202020416001601000002'
+  //     ]
+  //   }
+  //   const variables = { subContractId: '55834baf25f40fe5a8d6ac83c5f2b76a1677ed3ddbd6a79c4dea274992982e2b' }
+  //   const bytecode = ralph.buildContractByteCode(compiled, variables)
+  //   expect(bytecode).toEqual(
+  //     '01024046405301000203021205160016015f14402055834baf25f40fe5a8d6ac83c5f2b76a1677ed3ddbd6a79c4dea274992982e2b1702a00016002a16012aa100a00016001601160201000200000202020416001601000002'
+  //   )
+  // })
+})

package/src/fixtures/address.json

@@ -0,0 +1,36 @@
+{
+  "hash": "16sR3EMn2BdFgENRhz6N2TJ78nfaADdv3prKXUQMaB6m3",
+  "details": {
+    "balance": "string",
+    "txNumber": 0
+  },
+  "transactions": [
+    {
+      "hash": "string",
+      "blockHash": "string",
+      "timestamp": 0,
+      "inputs": [
+        {
+          "outputRef": {
+            "hint": 0,
+            "key": "string"
+          },
+          "unlockScript": "string",
+          "txHashRef": "string",
+          "address": "string",
+          "amount": "string"
+        }
+      ],
+      "outputs": [
+        {
+          "amount": "string",
+          "address": "string",
+          "lockTime": 0,
+          "spent": "string"
+        }
+      ],
+      "gasAmount": 0,
+      "gasPrice": "string"
+    }
+  ]
+}

package/src/fixtures/balance.json

@@ -0,0 +1,9 @@
+{
+  "data": {
+    "balance": "0",
+    "balanceHint": "0 ALPH",
+    "lockedBalance": "0",
+    "lockedBalanceHint": "0 ALPH",
+    "utxoNum": 0
+  }
+}

package/src/fixtures/self-clique.json

@@ -0,0 +1,19 @@
+{
+  "data": {
+    "cliqueId": "02f342de9b742719e1e9c939c54a13db5a7e3c4926b04428cbc45d70f8e6bcef4d",
+    "networkId": 0,
+    "numZerosAtLeastInHash": 37,
+    "nodes": [
+      {
+        "address": "127.0.0.1",
+        "restPort": 12973,
+        "wsPort": 11973,
+        "minerApiPort": 10973
+      }
+    ],
+    "selfReady": true,
+    "synced": true,
+    "groupNumPerBroker": 4,
+    "groups": 4
+  }
+}

package/src/fixtures/transaction.json

@@ -0,0 +1,13 @@
+{
+  "created": {
+    "unsignedTx": "0ecd20654c2e2be708495853e8da35c664247040c00bd10b9b13",
+    "txId": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
+    "fromGroup": 2,
+    "toGroup": 1
+  },
+  "submitted": {
+    "txId": "503bfb16230888af4924aa8f8250d7d348b862e267d75d3147f1998050b6da69",
+    "fromGroup": 2,
+    "toGroup": 1
+  }
+}

package/src/fixtures/transactions.json

@@ -0,0 +1,179 @@
+{
+  "oneInputOneOutput": {
+    "hash": "c99559da00e05bf967227c452f9dc33904cc8aac9819f71ca9b3382d037317c1",
+    "blockHash": "000000000000d3a4088bd4a177dd4c99f8df7642e095dd6f375d99d3a4a2760a",
+    "timestamp": 1639679587756,
+    "inputs": [
+      {
+        "outputRef": {
+          "hint": 269352581,
+          "key": "25abffce393aea71c3acf15c701ada53d69ccb4361d28f4b980560bca3303864"
+        },
+        "unlockScript": "00026e6e0839c322d59b54feb6501b207b8439ada411839268a5842e298acf8608d5",
+        "txHashRef": "1bd6040d255021cb4a551644f343344a2f1f0f32093244cbb273f6cdef55567f",
+        "address": "16sR3EMn2BdFgENRhz6N2TJ78nfaADdv3prKXUQMaB6m3",
+        "amount": "100000000000000000000"
+      }
+    ],
+    "outputs": [
+      {
+        "hint": 1770492891,
+        "key": "685eedf4a7eef2cccd55dfcc0d7d72c2aef788b118236d2dc8b27d924206da9d",
+        "amount": "409200570768056060",
+        "address": "1D3cMU5kaHmm8rnhF5ZErqErnRgp5xopDheubHVUizWA2",
+        "spent": "4d8e564e1731ecc09e167211c25da7b91a3fab8096a951a0df3b7ce1549d6cd9"
+      },
+      {
+        "hint": 269352581,
+        "key": "162784ca82a5dfc796bc6514658453e51aacdb48ed7bec716850152a61b55b82",
+        "amount": "50000000000000000000",
+        "address": "16sR3EMn2BdFgENRhz6N2TJ78nfaADdv3prKXUQMaB6m3",
+        "spent": "f823bcb78fbbc6c18dea882fe697cb8be9c5e2cb020e65670041dbe39b80c3d8"
+      }
+    ],
+    "gasAmount": 68060,
+    "gasPrice": "100000000000"
+  },
+  "twoInputsOneOutput": {
+    "hash": "c99559da00e05bf967227c452f9dc33904cc8aac9819f71ca9b3382d037317c1",
+    "blockHash": "000000000000d3a4088bd4a177dd4c99f8df7642e095dd6f375d99d3a4a2760a",
+    "timestamp": 1639679587756,
+    "inputs": [
+      {
+        "outputRef": {
+          "hint": 269352581,
+          "key": "25abffce393aea71c3acf15c701ada53d69ccb4361d28f4b980560bca3303864"
+        },
+        "unlockScript": "00026e6e0839c322d59b54feb6501b207b8439ada411839268a5842e298acf8608d5",
+        "txHashRef": "1bd6040d255021cb4a551644f343344a2f1f0f32093244cbb273f6cdef55567f",
+        "address": "16sR3EMn2BdFgENRhz6N2TJ78nfaADdv3prKXUQMaB6m3",
+        "amount": "100000000000000000000"
+      },
+      {
+        "outputRef": {
+          "hint": 269352581,
+          "key": "25abffce393aea71c3acf15c701ada53d69ccb4361d28f4b980560bca3303864"
+        },
+        "unlockScript": "00026e6e0839c322d59b54feb6501b207b8439ada411839268a5842e298acf8608d5",
+        "txHashRef": "1bd6040d255021cb4a551644f343344a2f1f0f32093244cbb273f6cdef55567f",
+        "address": "16sR3EMn2BdFgENRhz6N2TJ78nfaADdv3prKXUQMaB6m3",
+        "amount": "100000000000000000000"
+      }
+    ],
+    "outputs": [
+      {
+        "hint": 1770492891,
+        "key": "685eedf4a7eef2cccd55dfcc0d7d72c2aef788b118236d2dc8b27d924206da9d",
+        "amount": "150000000000000000000",
+        "address": "1D3cMU5kaHmm8rnhF5ZErqErnRgp5xopDheubHVUizWA2",
+        "spent": "4d8e564e1731ecc09e167211c25da7b91a3fab8096a951a0df3b7ce1549d6cd9"
+      },
+      {
+        "hint": 269352581,
+        "key": "162784ca82a5dfc796bc6514658453e51aacdb48ed7bec716850152a61b55b82",
+        "amount": "50000000000000000000",
+        "address": "16sR3EMn2BdFgENRhz6N2TJ78nfaADdv3prKXUQMaB6m3",
+        "spent": "f823bcb78fbbc6c18dea882fe697cb8be9c5e2cb020e65670041dbe39b80c3d8"
+      }
+    ],
+    "gasAmount": 68060,
+    "gasPrice": "100000000000"
+  },
+  "twoInputsZeroOutput": {
+    "hash": "c99559da00e05bf967227c452f9dc33904cc8aac9819f71ca9b3382d037317c1",
+    "blockHash": "000000000000d3a4088bd4a177dd4c99f8df7642e095dd6f375d99d3a4a2760a",
+    "timestamp": 1639679587756,
+    "inputs": [
+      {
+        "outputRef": {
+          "hint": 269352581,
+          "key": "25abffce393aea71c3acf15c701ada53d69ccb4361d28f4b980560bca3303864"
+        },
+        "unlockScript": "00026e6e0839c322d59b54feb6501b207b8439ada411839268a5842e298acf8608d5",
+        "txHashRef": "1bd6040d255021cb4a551644f343344a2f1f0f32093244cbb273f6cdef55567f",
+        "address": "16sR3EMn2BdFgENRhz6N2TJ78nfaADdv3prKXUQMaB6m3",
+        "amount": "100000000000000000000"
+      },
+      {
+        "outputRef": {
+          "hint": 269352581,
+          "key": "25abffce393aea71c3acf15c701ada53d69ccb4361d28f4b980560bca3303864"
+        },
+        "unlockScript": "00026e6e0839c322d59b54feb6501b207b8439ada411839268a5842e298acf8608d5",
+        "txHashRef": "1bd6040d255021cb4a551644f343344a2f1f0f32093244cbb273f6cdef55567f",
+        "address": "16sR3EMn2BdFgENRhz6N2TJ78nfaADdv3prKXUQMaB6m3",
+        "amount": "100000000000000000000"
+      }
+    ],
+    "outputs": [
+      {
+        "hint": 1770492891,
+        "key": "685eedf4a7eef2cccd55dfcc0d7d72c2aef788b118236d2dc8b27d924206da9d",
+        "amount": "150000000000000000000",
+        "address": "1D3cMU5kaHmm8rnhF5ZErqErnRgp5xopDheubHVUizWA2",
+        "spent": "4d8e564e1731ecc09e167211c25da7b91a3fab8096a951a0df3b7ce1549d6cd9"
+      },
+      {
+        "hint": 269352581,
+        "key": "162784ca82a5dfc796bc6514658453e51aacdb48ed7bec716850152a61b55b82",
+        "amount": "50000000000000000000",
+        "address": "1D3cMU5kaHmm8rnhF5ZErqErnRgp5xopDheubHVUizWA3",
+        "spent": "f823bcb78fbbc6c18dea882fe697cb8be9c5e2cb020e65670041dbe39b80c3d8"
+      }
+    ],
+    "gasAmount": 68060,
+    "gasPrice": "100000000000"
+  },
+  "missingInputs": {
+    "hash": "c99559da00e05bf967227c452f9dc33904cc8aac9819f71ca9b3382d037317c1",
+    "blockHash": "000000000000d3a4088bd4a177dd4c99f8df7642e095dd6f375d99d3a4a2760a",
+    "timestamp": 1639679587756,
+    "outputs": [
+      {
+        "hint": 1770492891,
+        "key": "685eedf4a7eef2cccd55dfcc0d7d72c2aef788b118236d2dc8b27d924206da9d",
+        "amount": "150000000000000000000",
+        "address": "1D3cMU5kaHmm8rnhF5ZErqErnRgp5xopDheubHVUizWA2",
+        "spent": "4d8e564e1731ecc09e167211c25da7b91a3fab8096a951a0df3b7ce1549d6cd9"
+      },
+      {
+        "hint": 269352581,
+        "key": "162784ca82a5dfc796bc6514658453e51aacdb48ed7bec716850152a61b55b82",
+        "amount": "50000000000000000000",
+        "address": "1D3cMU5kaHmm8rnhF5ZErqErnRgp5xopDheubHVUizWA3",
+        "spent": "f823bcb78fbbc6c18dea882fe697cb8be9c5e2cb020e65670041dbe39b80c3d8"
+      }
+    ],
+    "gasAmount": 68060,
+    "gasPrice": "100000000000"
+  },
+  "missingOutputs": {
+    "hash": "c99559da00e05bf967227c452f9dc33904cc8aac9819f71ca9b3382d037317c1",
+    "blockHash": "000000000000d3a4088bd4a177dd4c99f8df7642e095dd6f375d99d3a4a2760a",
+    "timestamp": 1639679587756,
+    "inputs": [
+      {
+        "outputRef": {
+          "hint": 269352581,
+          "key": "25abffce393aea71c3acf15c701ada53d69ccb4361d28f4b980560bca3303864"
+        },
+        "unlockScript": "00026e6e0839c322d59b54feb6501b207b8439ada411839268a5842e298acf8608d5",
+        "txHashRef": "1bd6040d255021cb4a551644f343344a2f1f0f32093244cbb273f6cdef55567f",
+        "address": "16sR3EMn2BdFgENRhz6N2TJ78nfaADdv3prKXUQMaB6m3",
+        "amount": "100000000000000000000"
+      },
+      {
+        "outputRef": {
+          "hint": 269352581,
+          "key": "25abffce393aea71c3acf15c701ada53d69ccb4361d28f4b980560bca3303864"
+        },
+        "unlockScript": "00026e6e0839c322d59b54feb6501b207b8439ada411839268a5842e298acf8608d5",
+        "txHashRef": "1bd6040d255021cb4a551644f343344a2f1f0f32093244cbb273f6cdef55567f",
+        "address": "16sR3EMn2BdFgENRhz6N2TJ78nfaADdv3prKXUQMaB6m3",
+        "amount": "100000000000000000000"
+      }
+    ],
+    "gasAmount": 68060,
+    "gasPrice": "100000000000"
+  }
+}

package/src/index.ts

@@ -24,5 +24,3 @@ export * from './transaction'
 
 export * from './constants'
 export * from './global'
-
-export * as utils from './utils'

package/src/signer/fixtures/genesis.json

@@ -0,0 +1,26 @@
+[
+  {
+    "address": "19XWyoWy6DjrRp7erWqPfBnh7HL1Sb2Ub8SVjux2d71Eb",
+    "pubKey": "03d3400977a9dabf737714ce672dd60e3e74afc7f9d61fa6a6d74f3e2909f7dc00",
+    "priKey": "fff733a4e95a5366625610e30d942587168130f82785c3609d92ae84c149e05e",
+    "mnemonic": "space window beach above tiger attract barrel noodle autumn grain update either twelve security shoe teach quote flip reflect maple bike polar ivory gadget"
+  },
+  {
+    "address": "1CsutTzw8WVhqr1PB6F1tYinuLihAsAm9FxE7rVkC3Z2u",
+    "pubKey": "02b3a0175856c1ac653720cc05eeb84263ec2036e9eeced748e8d643a8607901ae",
+    "priKey": "f004e2a5b9435531adef0954ce4106a494731379ee626365907d4e3ac639e9c6",
+    "mnemonic": "length hazard scene rabbit tiny soup page almost argue helmet cliff soap then bean artist teach guess sense dose near topic dinner option isolate"
+  },
+  {
+    "address": "1CwD52BrUj9e4WDJSZ7RXLU2A8us4ZFSmYBDKu98p7szi",
+    "pubKey": "03372b642615c8f32a4af2ca318bc5fc471828428dbc11e29d1a816d0d208d217d",
+    "priKey": "7ed7be6e1ba50c217b06f70a0b1e26e844907b3dec2e479ff5d206ad62a073e9",
+    "mnemonic": "head add industry horn prepare green budget divide attack reason finish purse flip congress book allow message salute turkey video quote pulse present private"
+  },
+  {
+    "address": "1BHSQ8JMeYHZe2kj3KmLjuQCSM3mvzYjNutz14uRPbxZM",
+    "pubKey": "02ea6e8cf78e57d4ab758ded570e1a6cd721e6586f34a1200f55a3d3c2a1b0374f",
+    "priKey": "7ced95c635863187db397d1b6406497654d27202e9b69edf9ae7f23ab346984b",
+    "mnemonic": "lottery mystery chase fatal rural snake moral cricket cash south pitch enlist loyal point turkey rally journey earth rifle deputy metal arm hospital tree"
+  }
+]

package/src/signer/fixtures/wallets.json

@@ -0,0 +1,26 @@
+{
+  "wallets": [
+    {
+      "mnemonic": "scan pause slender around cube flavor neck shrug gadget ramp rude lend capable tone nose unhappy gift across cluster minor tragic fever detail script",
+      "seed": "f585d130dd79d3b5bd63aa99d9bc6e6107cfbbe393b86d70e865f6e75c60a37496afc1b25cd4d1ab3b82d9b41f469c6c112a9f310e441814147ff27a5d65882b",
+      "password": "36ae0b75ef06d2e902e473c879c6e853193760ffa5dc29dc8da76133149e0892",
+      "file": {
+        "encrypted": "b686b4fff0c97e7fcacfd47babccf3ebac60c65035ed1370741424b3de5dbb75d87ac7f7bc0a2309725ec3370c53cd0bc705e3d1e919cdbad539d334398498d29b97689b37c9447b4aaeef3b99d11cadb85028ece6baa62fe74750a26d02f06a71b8e2ff69e112d78999c7f787a7029120bc25ad28e2acfaf4f088b30fea2973e30bd3ced24880a610c121ceddab4e271c17d6dcd0bcec7e6aff921c9409a0bb2e478a5028f1aacc70c72ee7fc64ebc58b4e63db",
+        "salt": "fd90b530931ad2fc9a195b719c7f1ecea8519e49a5e9b96d527c87549445c587dd34385f28446b570062286e79600430d190a885198b224e1b10678a0cd6648b",
+        "iv": "620bec5b5c612ac5f1f82b529dbdb818ba78c0d5e298a08d4ed9ea63a0bf762ca54414d12bd312e101d16ef95350c46b5ea18cf78d83ed025d5a400406bcdf70",
+        "version": 1
+      }
+    },
+    {
+      "mnemonic": "fence motor uncle pass zero curve garlic match palm kingdom quality keep undo scissors host lend ginger human loop mad sting horse swap track",
+      "seed": "f346de0a6cb3c8f50eb651ed4f17d572f7184813d3366215b4a1a61d7c776bedca41373d9008176bac8cb2ff8216d5cc3542f37fd520b4938295ca85013dbb3c",
+      "password": "36ae0b75ef06d2e902e473c879c6e853193760ffa5dc29dc8da76133149e0892",
+      "file": {
+        "encrypted": "d908a9e2816be754f17b4e80789546783d9e4538240e6585fda17c16343569d03aaac0a10c61122e23d9aa1c988f55d9e88b4d7b271e1f631e8aee02d5dc9e077e6150732381ec06c6f18d4fdde7ed3e09494762d002232a12fbcb5d1f0ca9ac3e6d964d3eb06ed530b10b8b151a66e2ea1eb4e60241b24c631edb31aa7ae99cf5c7f74692f39c534e7deee4e168375da2e6b93b7236fdfcafaade2d2e641498e61888b16d05147a43bb8024",
+        "salt": "e30c12732903502d8257cec78c3a1d25b29cd77a45378c43d4c9aed0386fd3c278149354221bdcf18e156d6384f1cb20c120975957f37fa433526f516528d597",
+        "iv": "d28a2821343d525a5afc8a17167e0e7f52a7dbc36dcbfbc95819c7f33afd5c6a1cc97a65a2b2bc95387b220a2e9fda7237bd897dfd59ab98e9a7add0c5eeab30",
+        "version": 1
+      }
+    }
+  ]
+}

package/src/signer/index.ts

@@ -17,3 +17,4 @@ along with the library. If not, see <http://www.gnu.org/licenses/>.
 */
 
 export * from './signer'
+export * from './node-wallet'

package/src/signer/node-wallet.ts

@@ -0,0 +1,65 @@
+/*
+Copyright 2018 - 2022 The Alephium Authors
+This file is part of the alephium project.
+
+The library is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+The library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with the library. If not, see <http://www.gnu.org/licenses/>.
+*/
+
+import { Account, SignerWithNodeProvider } from '../signer'
+
+export class NodeWallet extends SignerWithNodeProvider {
+  public walletName: string
+  public accounts: Account[] | undefined
+
+  constructor(walletName: string, alwaysSubmitTx = true) {
+    super(alwaysSubmitTx)
+    this.walletName = walletName
+  }
+
+  async getAccounts(): Promise<Account[]> {
+    if (typeof this.accounts === 'undefined') {
+      this.accounts = await this.getAllAccounts()
+    }
+    return this.accounts
+  }
+
+  private async getAllAccounts(): Promise<Account[]> {
+    const walletAddresses = await this.provider.wallets.getWalletsWalletNameAddresses(this.walletName)
+    const accounts: Account[] = walletAddresses.addresses.map<Account>((acc) => ({
+      publicKey: acc.publicKey,
+      address: acc.address,
+      group: acc.group
+    }))
+    return accounts
+  }
+
+  async signRaw(signerAddress: string, hexString: string): Promise<string> {
+    const currentActiveAddressResponse = await this.provider.wallets.getWalletsWalletNameAddresses(this.walletName)
+    const { activeAddress } = currentActiveAddressResponse
+    await this.provider.wallets.postWalletsWalletNameChangeActiveAddress(this.walletName, { address: signerAddress })
+    const { signature } = await this.provider.wallets.postWalletsWalletNameSign(this.walletName, { data: hexString })
+
+    await this.provider.wallets.postWalletsWalletNameChangeActiveAddress(this.walletName, { address: activeAddress }) // set the address that's active back to previous state
+
+    return signature
+  }
+
+  async unlock(password: string): Promise<void> {
+    return await this.provider.wallets.postWalletsWalletNameUnlock(this.walletName, { password })
+  }
+
+  async lock(): Promise<void> {
+    return await this.provider.wallets.postWalletsWalletNameLock(this.walletName)
+  }
+}

package/src/test/index.ts

@@ -0,0 +1,31 @@
+/*
+Copyright 2018 - 2022 The Alephium Authors
+This file is part of the alephium project.
+
+The library is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+The library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with the library. If not, see <http://www.gnu.org/licenses/>.
+*/
+
+import { NodeWallet } from '../signer'
+
+export const testWalletName = 'alephium-web3-test-only-wallet'
+export const testAddress = '1DrDyTr9RpRsQnDnXo2YRiPzPW4ooHX5LLoqXrqfMrpQH'
+export const testPassword = 'alph'
+
+export async function testNodeWallet(): Promise<NodeWallet> {
+  const wallet = new NodeWallet(testWalletName)
+  await wallet.unlock(testPassword)
+  return wallet
+}
+
+export * from './privatekey-wallet'

package/src/test/privatekey-wallet.ts

@@ -0,0 +1,57 @@
+/*
+Copyright 2018 - 2022 The Alephium Authors
+This file is part of the alephium project.
+
+The library is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+The library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with the library. If not, see <http://www.gnu.org/licenses/>.
+*/
+
+import { ec as EC } from 'elliptic'
+import { Account, SignerWithNodeProvider } from '../signer'
+import * as utils from '../utils'
+
+const ec = new EC('secp256k1')
+
+export class PrivateKeyWallet extends SignerWithNodeProvider {
+  readonly privateKey: string
+  readonly publicKey: string
+  readonly address: string
+  readonly group: number
+
+  constructor(privateKey: string, alwaysSubmitTx = true) {
+    super(alwaysSubmitTx)
+    this.privateKey = privateKey
+    this.publicKey = utils.publicKeyFromPrivateKey(privateKey)
+    this.address = utils.addressFromPublicKey(this.publicKey)
+    this.group = utils.groupOfAddress(this.address)
+  }
+
+  static Random(alwaysSubmitTx = true): PrivateKeyWallet {
+    const keyPair = ec.genKeyPair()
+    return new PrivateKeyWallet(keyPair.getPrivate().toString('hex'), alwaysSubmitTx)
+  }
+
+  async getAccounts(): Promise<Account[]> {
+    return [{ address: this.address, publicKey: this.publicKey, group: this.group }]
+  }
+
+  async signRaw(signerAddress: string, hexString: string): Promise<string> {
+    if (signerAddress !== this.address) {
+      throw Error('Unmatched signer address')
+    }
+
+    const key = ec.keyFromPrivate(this.privateKey)
+    const signature = key.sign(hexString)
+    return utils.signatureEncode(signature)
+  }
+}

package/src/transaction/index.ts

@@ -16,4 +16,5 @@ You should have received a copy of the GNU Lesser General Public License
 along with the library. If not, see <http://www.gnu.org/licenses/>.
 */
 
+export * from './sign-verify'
 export * from './status'