Wallet API

The API is designed for dapps to:

• connect to the user’s wallet,

• read identity + balance,

• sign messages, and

• construct/sign/push Trac Network transfers.

Conventions

• All methods are async and return Promises.

• Hex strings are lowercase/uppercase tolerant unless stated otherwise.

• Addresses are Bech32m strings with trac1... prefix.

• Amounts/balances are returned as strings (typically smallest-unit / integer strings).

Methods

tracnetwork.requestAccount()

Connects the wallet and returns the connected address.

Params: none Returns: Promise<string> wallet address

const address = await window.tracnetwork.requestAccount();

Example response:

trac1wnky35sgxefesuja46yvyf3tmf7pneeqv3ns5pk5pjlzu082f23s4r7923

---

tracnetwork.getAddress()

Returns the currently connected address.

Params: none Returns: Promise<string> wallet address

const address = await window.tracnetwork.getAddress();

---

tracnetwork.getBalance()

Returns the TNK balance of the connected account.

Params: none Returns: Promise<string> balance

const balance = await window.tracnetwork.getBalance();

Example response:

938000000000000000

---

tracnetwork.getNetwork()

Returns the current wallet network.

Params: none Returns: Promise<string> "livenet" or "testnet"

const network = await window.tracnetwork.getNetwork();

---

tracnetwork.switchNetwork(network)

Switches wallet network.

Params:

• network: string (expected: "livenet" or "testnet")

Returns: Promise<string> network

await window.tracnetwork.switchNetwork("testnet");

Example response:

testnet

---

tracnetwork.getPublicKey()

Returns the connected wallet public key (hex).

Params: none Returns: Promise<string> public key hex (32 bytes / 64 hex chars)

const pubKey = await window.tracnetwork.getPublicKey();

Example response:

74ec48d208365398725dae88c2262bda7c19e72064670a06d40cbe2e3cea4aa3

---

tracnetwork.signMessage(message)

Signs an arbitrary message.

Params:

• message: string

Returns: Promise<{ signature: string, publicKey: string, address: string }>

const sig = await window.tracnetwork.signMessage("hello");

Example response shape:

{
  "signature": "<hex-signature>",
  "publicKey": "<hex-publicKey>",
  "address": "trac1..."
}

Notes:

• The exact signing semantics (UTF-8 string bytes vs hex-decoding) are wallet-implementation defined.

• If you use this to sign a trac-peer prepared tx hash, ensure the wallet signs the same bytes that the peer verifies.

---

tracnetwork.sendTNK(fromAddress, toAddress, value)

Transfers TNK.

Params:

• fromAddress: string

• toAddress: string

• value: string | number

Returns: Promise<{ txHash: string, success: boolean }>

const res = await window.tracnetwork.sendTNK(fromAddress, toAddress, value);

Example response:

{
  "txHash": "6f7d901d63405873f3e845858b213603762bc4a1846a3f197a5a85092f84dd73",
  "success": true
}

---

tracnetwork.buildTracTx({ to, amount })

Builds a Trac Network transfer transaction payload (unsigned).

Params:

• { to: string, amount: string | number }

Returns: Promise<object> tx data

const txData = await window.tracnetwork.buildTracTx({ to: recipient, amount: val });

Example response shape (fields may vary by wallet version):

{
  "networkId": 918,
  "hash": "<hex32>",
  "from": "trac1...",
  "to": "trac1...",
  "amount": "<hex>",
  "validity": "<hex>",
  "nonce": "<hex>",
  "amountHex": "<hex>",
  "validityHex": "<hex>",
  "chainId": 918,
  "_bufferFields": ["hash", "nonce"]
}

---

tracnetwork.signTracTx(txData)

Signs a Trac Network transfer transaction payload (from buildTracTx).

Params:

• txData: object (output of buildTracTx)

Returns: Promise<string> signed payload (described as “payload jwt” in the PDF)

const payload = await window.tracnetwork.signTracTx(txData);

---

tracnetwork.pushTracTx(payload)

Pushes a signed Trac Network transfer transaction (from signTracTx).

Params:

• payload: string

Returns: Promise<{ txHash: string, success: boolean }>

const result = await window.tracnetwork.pushTracTx(payload);

Example response:

{
  "txHash": "c3ce135ccc8e5d27b1b9ed153b05fada9937c5bf07085c4dbde601cb763f33e4",
  "success": true
}