DEVELOPER GUIDE

Connect wallet with automatic popup. Use this first!

const result = await window.krayWallet.requestAccounts();
if (result.success) {
    console.log('Address:', result.address);
    console.log('Public Key:', result.publicKey);
}

Silent connect (no popup if already unlocked)

const result = await window.krayWallet.connect();
// Returns { success: true, address, publicKey, balance }

Get all accounts (array)

const accounts = await window.krayWallet.getAccounts();
// Returns ['bc1p...'] — array with full Bitcoin taproot address

Get public key (hex)

const pubKey = await window.krayWallet.getPublicKey();
// Returns x-only hex string directly (e.g. '5a4566...' — 64 chars)
// This is NOT an object. It's a plain string.
// To get the bc1p... address, use getAccounts() instead.

Verify it's genuine KRAY Wallet

const info = window.krayWallet.getExtensionInfo();
// { signature, version, build, isKrayWallet: true }

Get BTC balance in satoshis

const balance = await window.krayWallet.getBalance();
// Returns 150000 (sats)

Get user's Ordinals/NFTs

const { total, list } = await window.krayWallet.getInscriptions();
list.forEach(nft => {
    console.log('ID:', nft.inscriptionId);
    console.log('Preview:', nft.preview);
    console.log('UTXO:', nft.utxo);
});

Get user's Runes tokens

const { runes } = await window.krayWallet.getRunes();
runes.forEach(rune => {
    console.log('Name:', rune.spacedRune);
    console.log('Amount:', rune.amount);
    console.log('Symbol:', rune.symbol);
});

Get EVERYTHING at once: balance + ordinals + runes

const data = await window.krayWallet.getFullWalletData();
console.log('Address:', data.address);
console.log('Balance:', data.balance);
console.log('NFTs:', data.inscriptions.length);
console.log('Runes:', data.runes.length);

Auto-sign — If wallet is already unlocked, signs silently without popup. The user does NOT see or confirm anything. If locked, falls back to popup.

Only for actions that do NOT move KRAY or tokens: login, identity verification, read-only proofs. The user has no chance to review or cancel.

const { signature, address } = await window.krayWallet.signMessage('verify:login:timestamp');
// Returns { signature: '64-byte hex', address: 'bc1p...' }
// ⚠️ If wallet is unlocked, signs INSTANTLY — no popup, no password, no confirmation

Always popup — ALWAYS opens the KrayWallet confirmation popup, even if the wallet is already unlocked. The user sees exactly what they are signing, types their password, and clicks to confirm.

Use for ALL value-moving actions: claims, transfers, purchases, minting, tips. The user explicitly approves every action.

const { signature, address } = await window.krayWallet.signMessageWithConfirmation(message);
// Returns { signature: '64-byte hex', address: 'bc1p...' }
// ✅ ALWAYS opens popup → user sees the message → types password → confirms

Pay Lightning invoice

const result = await window.krayWallet.sendPayment('lnbc100n1...');
if (result.success) {
    console.log('Paid! Preimage:', result.preimage);
}

Get user's Ordinals (NFTs inscribed on Bitcoin)

const { total, list } = await window.krayWallet.getInscriptions();
list.forEach(ordinal => {
    console.log('Inscription ID:', ordinal.inscriptionId);
    console.log('Content Type:', ordinal.contentType);
    console.log('Preview:', ordinal.preview);
});

Get user's Runes tokens

const { runes } = await window.krayWallet.getRunes();
runes.forEach(rune => {
    console.log('Rune:', rune.spacedRune);
    console.log('Amount:', rune.amount);
    console.log('Symbol:', rune.symbol);
});

Get current network (livenet/testnet)

const network = window.krayWallet.getNetwork();
// Returns 'livenet'

Get active layer (mainnet or kray-l2)

const layer = await window.krayWallet.getActiveNetwork();
// Returns 'mainnet' or 'kray-l2'

Start encrypted chat session (opens popup for password)

const { publicKey } = await window.krayWallet.activateChatSession();
// Share publicKey with your backend for others to message you

Encrypt message for recipient

const encrypted = await window.krayWallet.encryptChatMessage(
    'Hello!',
    recipientPublicKey
);
// Send encrypted to your backend

Decrypt message from sender

const message = await window.krayWallet.decryptChatMessage(
    encryptedPayload,
    senderPublicKey
);
console.log('Message:', message);

Check if chat session is active

const { active, publicKey } = await window.krayWallet.isChatSessionActive();

End chat session (logout)

await window.krayWallet.clearChatSession();