PermanentWallet Documentation

PermanentWallet is the world's first permanent, multi-chain crypto wallet naming platform. It replaces dangerous 42-character hex wallet addresses with human-readable domain names owned permanently on-chain — no renewal fees, no expiry dates, no risk of losing your identity.

The platform operates as a two-tier open marketplace: anyone can register a domain extension and earn 50% of every domain sold under it — forever, on-chain, automatically.

Problems We Solve

The 42-character hexadecimal wallet address format was designed for cryptographic security — not for humans. This creates six distinct, costly, and entirely preventable problems.

1. Address Poisoning Attacks

Attackers send tiny transactions from addresses resembling your legitimate contacts — differing only in middle characters. When you copy from your transaction history, you may grab the poisoned address. Funds gone. No recourse.

2. Clipboard Hijacking (Clipper Malware)

Clipper malware silently monitors your device clipboard. The moment it detects a cryptocurrency wallet address, it instantly replaces it with the attacker's address. Advanced variants like Laplas Clipper generate replacement addresses matching the first and last characters of the original — defeating the common "check first/last chars" verification habit.

With a permanent domain name, you type benson.erc20 — you never need to copy a raw address. Clipboard hijacking is completely eliminated.

3. The Sharing Nightmare

Sharing a 42-character hex string via email, text, or invoice creates multiple failure modes: you paste it wrong, they copy it wrong, you forget to label the blockchain layer, you label it incorrectly, or you send on the wrong network. Any of these results in permanent fund loss. The name benson.erc20 carries its own chain context — no disclaimer needed.

4. Wrong Network Sends

Ethereum, BNB Chain, Avalanche, Tron, and Polkadot share identical address formats (0x hex). Sending USDT on Ethereum to a BNB Chain address results in funds stranded or permanently lost. The blockchain cannot distinguish intent from error. Chain-specific extensions (.bnb, .avax, .trx) make this impossible.

5. All Existing Naming Services Expire

Miss a renewal and your domain is immediately claimable by anyone — including attackers who snatch lapsed domains to redirect incoming funds.

6. QR Code Swapping Attacks

Attackers replace legitimate crypto QR codes on websites, invoices, and printed materials with codes encoding their own wallet. Since the hex string is meaningless to humans, victims cannot verify the destination before scanning. A human-readable domain displayed alongside is always visually verifiable.

Quick Start

Register a Domain (Ethereum — Live Now)

Register an Extension (Earn Passive Income)

How Resolution Works

Name Hashing

function nameHash(string memory name, string memory extension)
    internal pure returns (bytes32)
{
    return keccak256(abi.encodePacked(
        keccak256(abi.encodePacked(name)),
        keccak256(abi.encodePacked(extension))
    ));
}

Permanent Ownership

Permanent ownership is enforced at the data structure level — not just as a policy. The Domain struct has no expiry field:

struct Domain {
    address owner;
    string  resolvedAddress;
    string  extension;
    uint256 registeredAt;
    // NO expiry field. No renewal function.
    // This domain is permanent by mathematical design.
}

The Two-Tier Model

Tier 1 — Extension Owners

Anyone registers a domain extension (max 5 characters) by paying a one-time fee. As an extension owner, you earn 50% of every domain registration and 2.5% of every secondary market sale under your extension — automatically, on-chain, forever.

Tier 2 — Domain Holders

End users register a domain under any available extension with a one-time payment. Domain is permanently registered. No renewals. No expiry.

Revenue Flow

Domain registration (third-party extension):
  50% → PermanentWallet treasury
  50% → Extension owner wallet (automatic, on-chain)

Domain registration (PW-owned extension):
  100% → PermanentWallet treasury

Extension registration fee:
  100% → PermanentWallet treasury

Secondary market sale:
  95%  → Domain seller
  2.5% → PermanentWallet platform
  2.5% → Extension owner

Extensions

Registration Fees by Length

Secondary Market

Contract Architecture

Languages by Chain

ExtensionRegistry Contract

struct Extension {
    address owner;
    uint256 domainPrice;
    uint8   minDomainLength;
    uint256 registeredAt;
    uint256 totalDomains;
    uint256 revenueAccrued;
    bool    isActive;
    string  description;
}

function _splitPayment(string memory ext, uint256 amount) internal {
    Extension storage e = extensions[keccak256(bytes(ext))];
    uint256 platformShare = (amount * 50) / 100;
    uint256 ownerShare    = amount - platformShare;
    (bool ok1,) = platformTreasury.call{value: platformShare}("");
    require(ok1, "Platform transfer failed");
    (bool ok2,) = e.owner.call{value: ownerShare}("");
    require(ok2, "Owner transfer failed");
    e.revenueAccrued += ownerShare;
}

DomainRegistry Contract

function registerDomain(
    string calldata name,
    string calldata ext
) external payable nonReentrant {
    require(extensionRegistry.isActive(ext), "Extension not active");
    require(!extensionRegistry.isDisabled(ext), "Extension disabled");
    bytes32 dHash = nameHash(name, ext);
    require(_domains[dHash].owner == address(0), "Already registered");
    require(msg.value >= extensionRegistry.getDomainPrice(ext), "Insufficient");
    extensionRegistry._splitPayment(ext, msg.value);
    _domains[dHash] = Domain({
        owner:           msg.sender,
        resolvedAddress: addressToString(msg.sender),
        extension:       ext,
        registeredAt:    block.timestamp
        // NO expiry field
    });
    _ownerDomains[msg.sender].push(dHash);
    emit DomainRegistered(name, ext, msg.sender, msg.value);
}

Payment Splits

Ethereum (Live Now)

Solana (Building)

Bitcoin (Building)

Bitcoin has no native smart contracts. PermanentWallet builds on Stacks L2 using Clarity — a decidable, secure language anchored to Bitcoin, enabling sBTC payments.

Other Chains (Coming Soon)

Competitor Map

Resolving Names

import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider('https://mainnet.infura.io/v3/YOUR_KEY');
const registry = new ethers.Contract(REGISTRY_ADDRESS, REGISTRY_ABI, provider);

// Forward: name → address
async function resolveDomain(name, extension) {
    return await registry.resolve(name, extension);
}

// Reverse: address → names
async function lookupWallet(walletAddress) {
    return await registry.reverseResolve(walletAddress);
}

// Usage
const addr = await resolveDomain('benson', 'erc20');
// → "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"

Disabled Extensions

Cross-chain: Each chain's native extension is disabled on all other chains (.btc, .eth, .sol, .bnb, .avax, .xrp, .trx, .ada, .dot, .sui, .near, .atom, .xlm — each disabled except on their own chain).

Financial protection: .bank .visa .swift .paypal .stripe .fed .sec

Security protection: .admin .root .system .wallet .seed .key .safe .official .verify .auth .sign .recovery

Platform reserved: .pw .perm .pwallet .test .null .void .help

Pricing

Frequently Asked Questions

Can my domain ever expire?

No. The smart contract contains no expiry field and no renewal function. It is mathematically impossible for your domain to expire after registration.

Can I transfer my domain to another wallet?

Domain ownership is non-transferable by default. You can list a domain for sale on the secondary marketplace, which handles the transfer atomically on-chain.

Can I update the wallet address my domain points to?

Yes. Only the domain owner can update the resolved address. Useful if you switch wallets.

What if I lose access to my wallet?

Your domain is tied to your wallet. Loss of private keys means loss of access to your domain. There is no recovery mechanism. Store your seed phrase securely offline.

Can PermanentWallet disable my domain?

No. Once registered, no admin can modify or delete your domain record. Only you can update the resolved address.

Can the same domain exist on multiple chains?

Yes. benson.sol and benson.bnb are entirely separate registrations on different chains.

Security

• Reentrancy protection (OpenZeppelin ReentrancyGuard) on all payable functions
• Atomic payment splits — both transfers succeed or transaction reverts
• No admin keys can modify existing domain records
• Immutable core — no upgrade mechanism after mainnet deployment
• Emergency pause for new registrations only (existing records unaffected)
• Multi-sig governance for all administrative operations

Report a Vulnerability

Report security vulnerabilities responsibly to [email protected]. Do not publicly disclose before giving us reasonable time to respond.