Wallet Management

🔐 Wallet Management

The ToroForge Node.js SDK offers complete tools for managing user wallets on the Toronet blockchain — including creation, import, name registration (TNS), password verification, and key access.

---

📘 What You Can Do

• Create a new Toronet wallet

• Assign a Toronet Naming System (TNS) name

• Import an existing wallet using a private key

• Verify wallet password integrity

• Retrieve wallet keys securely

---

🧱 Features & Usage

---

✅ Create a New Wallet

Generate a new wallet address by providing a secure password.

import { createWallet } from 'torosdk';

const walletAddress = await createWallet({
  password: 'securePassword123',
});

Returns a Toronet-compatible wallet address.

---

🧠 Assign a TNS (Toronet Name)

Once a wallet is created, you can register a human-readable name for the address.

import { setTNSName } from 'torosdk';

await setTNSName({
  address: '0xWalletAddress',
  password: 'securePassword123',
  username: 'exampleName',
});

Names are unique and can be used across the Toronet ecosystem.

---

🔁 Import Wallet From Private Key

If a user already has a private key, import it into the SDK with a new password.

import { importWalletFromPrivateKeyAndPassword } from 'torosdk';

const address = await importWalletFromPrivateKeyAndPassword({
  pvkey: 'yourPrivateKeyHere',
  password: 'newWalletPassword',
});

---

🔒 Verify Wallet Password

Check whether a given password is valid for a Toronet address.

import { verifyWalletPassword } from 'torosdk';

const isValid = await verifyWalletPassword({
  address: '0xWalletAddress',
  password: 'testPassword',
});

Returns true or false.

---

🔑 Retrieve Wallet Key

Use this only when absolutely necessary (e.g. for backup or migrations):

import { getWalletKey } from 'torosdk';

const keyInfo = await getWalletKey({
  address: '0xWalletAddress',
});
console.log(keyInfo); // { pubkey, privkey }

⚠️ Always store keys securely. Never expose them on the frontend.

---

🧩 Best Practices

• Always encrypt passwords in transit and storage.

• Use environment variables for admin credentials when working with wallet APIs that require authorization.

• Avoid calling getWalletKey() on the client side.

---

📎 Related Sections

• Token & Balance Queries
• KYC Verification
• Fiat Deposits

---