nem2-test-dapps-wallet

Browser Extension Wallet (Alpha version)

symbol TEST_NET Only.

Credentials (private key) is stored in local storage and should not be used in a production environment (MAIN_NET)

Build Setup

# install dependencies
$ yarn install

# build for production
$ yarn build

You can see the build results in the dist directory. You can load this as an extension in each browser to see how it works.

Getting Started

Building a web application (dApps) using this browser extension.

Extension Detection

if (typeof window.nem2 !== 'undefined') {
  console.log('extension is installed!')
}

Accessing Accounts

window.nem2.getAccountInfo().then((accountInfo) => {
    // something
})

API Reference

Methods

nem2.getAccountInfo

nem2.getAccountInfo()

Parameters

none

Returns

Promise<Object>

• networkType: Number
• generationHash: String
• publicKey: String
• addressPlain: String
• epochAdjustment: Number
• currencyMosaicId: String
• harvestingMosaicId: String
• networkProperties: Object - REST API Response of /network/properties

Example

nem2.getAccountInfo().then((accountInfo) => {
    console.log(accountInfo)
})
/*
{
    "networkType": 152,
    "generationHash": "3B5E1FA6445653C971A50687E75E6D09FB30481055E3990C84B25E9222DC1155",
    "publicKey": "DFF2D798CF331CDDEC64FD9F8F565B3A78D3423700955B2EE03BDBD09F01E171",
    "addressPlain": "TAANPEY74KKND4QHPG5DZDPUY24NLPVLS6WIWWI",
    "epochAdjustment": 1616694977,
    "currencyMosaicId": "091F837E059AE13C",
    "harvestingMosaicId": "091F837E059AE13C",
    "networkProperties": {
        "network": {
            "identifier": "public-test",
            "nemesisSignerPublicKey": "2267B24107405779DDF0D8FBEABD8142B97105F356F3737B1FC02220E8F90FF2",
            "nodeEqualityStrategy": "host",
            "generationHashSeed": "3B5E1FA6445653C971A50687E75E6D09FB30481055E3990C84B25E9222DC1155",
            "epochAdjustment": "1616694977s"
        },
        "chain": {
            "enableVerifiableState": true,
            "enableVerifiableReceipts": true,
            "currencyMosaicId": "0x091F'837E'059A'E13C",
            "harvestingMosaicId": "0x091F'837E'059A'E13C",
            "blockGenerationTargetTime": "30s",
            "blockTimeSmoothingFactor": "3000",
            "importanceGrouping": "180",
            "importanceActivityPercentage": "5",
            "maxRollbackBlocks": "0",
            "maxDifficultyBlocks": "60",
            "defaultDynamicFeeMultiplier": "100",
            "maxTransactionLifetime": "6h",
            "maxBlockFutureTime": "300ms",
            "initialCurrencyAtomicUnits": "7'842'928'625'000'000",
            "maxMosaicAtomicUnits": "8'999'999'999'000'000",
            "totalChainImportance": "7'842'928'625'000'000",
            "minHarvesterBalance": "10'000'000'000",
            "maxHarvesterBalance": "50'000'000'000'000",
            "minVoterBalance": "3'000'000'000'000",
            "votingSetGrouping": "720",
            "maxVotingKeysPerAccount": "3",
            "minVotingKeyLifetime": "28",
            "maxVotingKeyLifetime": "720",
            "harvestBeneficiaryPercentage": "25",
            "harvestNetworkPercentage": "5",
            "harvestNetworkFeeSinkAddress": "TCZ3UZPWWC5NR6TGGYEJ2MT4Z5ZLR3XTIVI4RHA",
            "maxTransactionsPerBlock": "6'000"
        },
        "plugins": {
          ...
        }
    }
}
 */

nem2.sign

nem2.sign (payload, message = '')

Parameters

It expects AggregateTransaction(Bonded/Complete), but if you enter anything else, it will return the meaningless result of signing the transaction hash.

1. String - transaction payload
2. String - message for signing popup

Returns

Promise<Object>

• payload: String
• hash: String
• signerPublicKey: String
• transactionType: Number
• networkType: Number

Example

In your web application, you may have imported the symbol-sdk

const networkType = 152
const generationHash = "3B5E1FA6445653C971A50687E75E6D09FB30481055E3990C84B25E9222DC1155"
const epochAdjustment = 1616694977
const mosaicId = "091F837E059AE13C"
const recipientAddress = "TCZ5KXKSAJA74A5ECZCXMHOHKFVQ36YSONW4RSA"
const endPoint = "http://ngl-dual-001.testnet.symboldev.network:3000"
const amount = 1000000
const tx = TransferTransaction.create(
    Deadline.create(epochAdjustment),
    Address.createFromRawAddress(recipientAddress),
    [new Mosaic(new MosaicId(mosaicId), UInt64.fromUint(amount))],
    PlainMessage.create(''),
    networkType,
    UInt64.fromUint(20000)
)
const account = Account.generateNewAccount(networkType)
const tempSignedTx = account.sign(tx, generationHash)
const signResult = await window.nem2.sign(tempSignedTx.payload, `${amount} ${mosaicId} to ${recipientAddress}`)
const signedTx = new SignedTransaction(
    signResult.payload,
    signResult.hash,
    signResult.signerPublicKey,
    signResult.transactionType,
    signResult.networkType
)
const repo = new RepositoryFactoryHttp(endPoint)
const txHttp = repo.createTransactionRepository()
txHttp.announce(signedTx)

nem2.cosign

nem2.cosign (payload, message = '')

Parameters

1. String - unsigned transaction payload (Even if it's signed, ignore it, so I expect it to be signed with a one-time account)
2. String - message for signing popup

Returns

Promise<Object>

1. signature: String
2. signer: Object
   1. publicKey: String
   2. address: Object
      1. address: String
      2. networkType: Nubmer
3. version: Object
   1. lower: Number - always 0
   2. higher: Number - always 0

Example

Aggregate Complete Example

const endPoint = "http://ngl-dual-001.testnet.symboldev.network:3000"

// something signed transaction
const signedTransaction = new SignedTransaction()

const cosignResult = await window.nem2.cosign(signedTransaction.payload, "cosign request")
const aggregateCosignature = new AggregateTransactionCosignature(
    cosignResult.signature,
    PublicAccount.createFromPublicKey(cosignResult.signer.publicKey, cosignResult.signer.address.networkType)
)
const cosignedWithoutSize = signedTransaction.payload
    + aggregateCosignature.version.toHex()
    + aggregateCosignature.signer.publicKey
    + aggregateCosignature.signature
const size = (cosignedWithoutSize.length / 2).toString(16).padStart(8, '0').toUpperCase()
const leSize = size.substr(-2, 2) + size.substr(-4, 2) + size.substr(-6, 2) + size.substr(-8, 2)
const cosignedPayload = leSize + cosignedWithoutSize.substr(8)
const cosignedTx = new SignedTransaction(
    cosignedPayload,
    signedTransaction.hash,
    signedTransaction.signerPublicKey,
    signedTransaction.type,
    signedTransaction.networkType
)
const repo = new RepositoryFactoryHttp(endPoint)
const txHttp = repo.createTransactionRepository()
txHttp.announce(cosignedTx)