Package Exports
- @nano/wallet
- @nano/wallet/nano.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@nano/wallet) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
Nano JS Wallet
BROWSER:
<script src="https://unpkg.com/@nano/wallet"></script>
NPM:
// npm install @nano/wallet
const nano = require('@nano/wallet')
Basic Usage
nano.app({
node: 'https://rpc.nano.to',
rpc_key: 'YOUR_RPC_KEY',
database: 'encrypted_wallets.txt',
secret: 'SUPER_SECRET_PASSWORD'
})
nano.add_account({ userId: 'JohnDoe' })
var payment = await nano.checkout({
address: { userId: 'JohnDoe' },
amount: '0.133'
})
var success = await nano.waitFor(payment)
// {
// id: 'b06a8127',
// success: true,
// block: '3C0D9A50649C6BE04263...A773C321EDD2603EFEB',
// json: 'https://api.nano.to/checkout/b06a8127',
// address: 'nano_37y6iq8m...xpb9jrcwhkmoxpo61f4o',
// browser: 'https://nanobrowse.com/block/3C0D9A50649C6BE04263...A773C321EDD2603EFEB',
// amount: '0.133',
// amount_raw: '1330000000000000000000000'
// }
OFFLINE API
nano.generate()
nano.import( nano.generate() )
nano.accounts()
nano.add_account()
nano.sign(block)
nano.convert('421.70', 'NANO', 'RAW') // 421700000000000000000000000000000
nano.encrypt('any_string', process.env.PASSWORD) // AES-256
nano.decrypt('any_string', process.env.PASSWORD) // UTF-8
nano.export()
PUBLIC RPC
await nano.qrcode()
var checkout = await nano.checkout({ address: 0, amount: '0.133' })
var payment = await nano.waitFor(checkout)
await nano.process(signedBlock)
await nano.balances()
await nano.receive()
// send to globally known accounts
await nano.send({ to: '@fosse', amount: 0.1 })
// transfer between your own accounts
await nano.send({ to: 1, from: 0, amount: 0.1 })
// transfer between your own users
await nano.send({ to: { userId: 'johnDoe' }, from: { userId: 'janeDoe' }, amount: 0.1 })
await nano.rpc({ action: "block_count" })
LOCALSTORAGE
Build non-custodial Nano applications by persisting Wallets client-side. Using AES-256 encryption. The longer
process.env.PASSWORD
, the more secure.
nano.app({
node: 'https://rpc.nano.to',
rpc_key: 'RPC_API_KEY', // get free key @ rpc.nano.to
database: 'aes_string.txt',
secret: 'SUPER_SECRET_PASSWORD'
})
console.log( nano.accounts() )
await nano.receive()
await nano.send({
to: [ 'nano_1faucet7b6xjyha7m13objpn5ubkquzd6ska8kwopzf1ecbfmn35d1zey3ys' ],
amount: nano.convert(0.001, 'NANO', 'RAW') // 'all'
})
METADATA
nano.app({
node: 'https://rpc.nano.to',
rpc_key: 'RPC_API_KEY', // get free key @ rpc.nano.to
database: 'aes_string.txt',
secret: 'SUPER_SECRET_PASSWORD'
})
const user = { userId: 'JoeDoe' }
console.log( nano.add_account(user) )
await nano.receive(user)
await nano.send({
to: user,
from: 0, // your first account
amount: '0.133'
})
IMPORT/EXPORT
JSON object, stringified and encrypted with AES-256
nano.offline({
filename: 'aes_string.txt',
password: process.env.PASSWORD
})
console.log( nano.export() )
Encrypted:
AES-256::U2FsdGVkX1+jBdpxz6hMNOqWmidZQPqHjOHq7sGi94U0dMuPZsDfPRGVVDVQH5ZfvXku6aqEfmoR9LwoBbKKxGxrAzOwf2SvNcmvwdAsgAkmieOwVOCDbob46yMN7TZUnRDIOSNq3tEozfaf9vbH3SdRZgkCukblN5m+lA0yxKSDaPiczANZMgP6NdtjMNo2SHVVmJhWgz4i8MDCfk6ZeZChxL6UyuqR0hKyY0wEtXHndTapQuVYQ/Oyvb9ccNfqvgxirmYERiXPEFi/vndPwmS2AEGih7fWndSARkXtLgG3xTI2tWYvoMIef4ZouiFtOhfOXuiab0OteoQmlmW6C03Nb4e2SZrFyyIF9wWkXDcpHSqPBUJJzOPF/p8c8fyEbhpe/iEs6pObrLOSoh8S+t016ZF3ARntCeBtMVZCiwVS94Ru+zGcDVxJiny/oBywznxPlkCAnf4m5Tn6E9LpeLdi14feuGTCerGYW3MYM3jJbqUGRuaGw6OB1hRcKtpe3QLR/lmnw1jRkpux6K+5P2p4GsacK/l0Ul5caGnCeQWeDll3q8DIFD4Qhvp1qnawhMvpYu/RCwVTGvLFlkhYS/DruJEQuVErHK8bhfAvPZaF3Eyw5qzCoUaukcl2S1i5HzPsMgcxSfRxCmCH37bKd8YfE3wiC+7AatsN1QOvzzY=
Decrypted:
{
"mnemonic": "body hire team image luxury banana panther tiny clog beauty only cover frost tourist process grit unlock rice",
"seed": "7202a6eb69fa3a465539648c35e55ad7e295f25c9a7a340f82b3d3e338f....33a4ee0939cd44a7abb1afe83ff2170cae4",
"accounts": [{
"accountIndex": 0,
"private": "d7cace49b3a20f83.....58cb61b8f2ef84f3",
"address": "nano_1h4ymsbu....3wotjakm1copzy56bd8na"
}]
}
License
MIT