Vaults

Your Vault Address
│
├── Normal Path — requires you + NEXUS together
│   └── Instant processing — standard deposits and withdrawals
│
└── Escape Path — requires only you, after a waiting period
    └── Emergency exit — works even if NEXUS is completely offline

Zcash Transparent Vault (t-addr)
├── Normal: <ProtocolKey> + <YourKey> (2-of-2, instant)
└── Escape: <16128-block timelock> + <YourKey> (unilateral, ~2 weeks wait)

Bitcoin Taproot Vault
├── Normal: <ProtocolKey> + <YourKey> (2-of-2, instant)
└── Escape: <2016-block timelock> + <YourKey> (unilateral, ~2 weeks wait)

Dogecoin P2PKH Vault
├── Normal: <ProtocolKey> + <YourKey> (2-of-2, instant)
└── Escape: <20160-block timelock> + <YourKey> (unilateral, ~2 weeks wait)

1. Get your vault address (Zcash t-addr)
   → SDK: client.getVaultAddress()
   → CLI: nexus wallet vault-address --chain zcash

2. Send ZEC to that address (standard zcash-cli transaction)

3. NEXUS detects your deposit after confirmations:
   - Zcash:    10 blocks (~12.5 min) ✅ Live
   - Bitcoin:   6 blocks (~60 min)   🔄 Coming soon
   - Dogecoin:  3 blocks (~3 min)    🔄 Coming soon

4. vZEC (or vSAT / vDOGE) credited to your NEXUS account

import { NexusClient } from '@yattacorp/nexus-sdk';

// Get your Zcash vault address
const vaultInfo = await client.getVaultAddress();
console.log('Send ZEC to:', vaultInfo.vaultAddress);
// e.g. "tmXxx..." on regtest, "t1xxx..." on mainnet

// After sending 10 confirmations (~12.5 min), check balance
const balance = await client.getBalance();
console.log('vZEC balance:', balance);

1. Request withdrawal on NEXUS
   → Your vSAT/vZEC/vDOGE are burned immediately

2. Withdrawal queued for batch processing
   → Batches improve on-chain efficiency and reduce fees

3. Protocol signs and broadcasts the L1 transaction

4. You receive BTC/ZEC/DOGE in your specified address

// Withdraw ZEC to a Zcash transparent address
// Returns: { success, txid, status, path, confirmed? }
const result = await client.withdrawFunds(
  'tmXxx...',  // destination Zcash t-addr (regtest) or t1xxx (mainnet)
  10_000_000,  // amount in zatoshi (0.1 ZEC)
  { waitForConfirmation: true }
);
console.log('Withdrawal txid:', result.txid);

// Vault addresses are derived server-side via the NEXUS node
// Uses nexus_deriveVaultFromPubkey RPC internally
const vaultInfo = await client.getVaultAddress(); // timelock: 16,128 blocks (~2 weeks on Zcash)
const vaultAddress = vaultInfo.vaultAddress; // e.g. "tmXxx..." on regtest, "t1xxx..." on mainnet