> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yattacorp.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# NEXUS-Dogecoin

> Smart contracts on Dogecoin — fast deposits, low fees, full programmability

<Warning>
  **NEXUS-Dogecoin launches after Zcash.** Zcash is the first live chain. Dogecoin support is fully designed and implemented — this page documents what Dogecoin integration will look like at launch.
</Warning>

## Overview

NEXUS-Dogecoin brings smart contracts to Dogecoin. Dogecoin's 1-minute block time makes it the **fastest deposit experience** in the NEXUS ecosystem — your deposit is confirmed in \~6 minutes vs \~60 minutes for Bitcoin.

**Why Dogecoin?**

* Fastest confirmations: \~3 minutes (3 blocks × 1 min)
* Lowest fees: ideal for micro-payments and small amounts
* Large, active community
* Real proof-of-work security

***

## How Trust Works on Dogecoin

NEXUS-Dogecoin uses the same trustless security model as Bitcoin:

1. **ZK-STARK proofs** — Every state update has a cryptographic proof of correctness
2. **Economic bonds** — Operators post collateral that is forfeited if they cheat
3. **Fraud proofs** — Anyone can challenge incorrect state with on-chain verification
4. **Escape hatch** — You can always withdraw unilaterally after the timelock

```
ZK-STARK Proofs (cryptographic guarantee)
          +
Economic Bonds + Fraud Proofs (financial guarantee)
          =
Trustless Verification with Fast Finality
```

***

## Dogecoin Vault Details

| Property              | Value                                                   |
| --------------------- | ------------------------------------------------------- |
| Address type          | [P2PKH](/glossary#p) — standard Dogecoin address format |
| Vault structure       | 2-of-2 (you + protocol) with [CLTV](/glossary#c) escape |
| Escape hatch          | 20,160 block timelock (\~2 weeks)                       |
| State commitments     | [OP\_RETURN](/glossary#o) outputs every \~60 blocks     |
| Deposit confirmations | 3 blocks (\~3 min)                                      |

***

## Supported Features (V1)

| Feature                       | Status                  |
| ----------------------------- | ----------------------- |
| Smart Contracts (WASM)        | ✅                       |
| P2PKH Vaults                  | ✅                       |
| Fast Deposits (\~6 min)       | ✅                       |
| State Commitments on Dogecoin | ✅                       |
| Cross-Contract Calls          | ✅                       |
| DOGE ↔ BTC Swaps              | 🔄 V2 (intent exchange) |
| DOGE ↔ ZEC Swaps              | 🔄 V2 (intent exchange) |
| Unified Liquidity Pools       | 🔄 V2                   |

***

## Deposit Guide

**1. Get your vault address**

```typescript theme={null}
const vault = await client.getVaultAddress(20160); // 20,160-block timelock (~2 weeks)
console.log('Send DOGE to:', vault.vaultAddress);
```

**2. Send Dogecoin**

```bash theme={null}
dogecoin-cli sendtoaddress <VAULT_ADDRESS> 1000
```

**3. Wait for 3 confirmations** (\~3 minutes — the fastest in NEXUS)

**4. Check your NEXUS balance**

```typescript theme={null}
const balance = await client.getBalance();
// Balance shown in DOGE units (vDOGE)
```

***

## Withdrawal Guide

```typescript theme={null}
// Returns: { success, txid, status, path, confirmed? }
const result = await client.withdrawFunds(
  'D...',    // your Dogecoin destination address
  100000,    // amount
);
console.log('Withdrawal txid:', result.txid);
```

***

## Confirmation Time Comparison

| Chain        | Block Time | Confirmations | Total Wait  |
| ------------ | ---------- | ------------- | ----------- |
| **Dogecoin** | **1 min**  | **3**         | **\~3 min** |
| Zcash        | 75 sec     | 10            | \~12.5 min  |
| Bitcoin      | 10 min     | 6             | \~60 min    |

Dogecoin is 20× faster than Bitcoin for getting funds into NEXUS.

***

## Use Cases Where Dogecoin Shines

**Micro-payments**
Low fees and fast blocks make DOGE perfect for small transactions — tipping, gaming rewards, micro-payments under \$1.

**Quick arbitrage**
Need to react to a price discrepancy? Dogecoin deposits confirm in 6 minutes.

**High-frequency DeFi**
More block time = more state commitment opportunities = more granular price tracking.

**Meme token launches**
Deploy a token, set up liquidity, go. The community is there.

```typescript theme={null}
// Deploy a meme token on NEXUS using DOGE
const token = await client.deployContract(memeTokenWasm, [
  'ShiNexus',       // name
  'SHINEX',         // symbol
  18,               // decimals
  '1000000000000'   // total supply
]);
console.log('Token address:', token.contractId);
```

***

## Configuration Reference

```toml theme={null}
[dogecoin]
rpc_url = "http://localhost:22555"
rpc_user = "user"
rpc_password = "password"
network = "regtest"  # mainnet | testnet | regtest

[dogecoin.vault]
escape_timelock = 20160  # ~2 weeks (1-min blocks × 20160)

[dogecoin.state_commit]
interval_blocks = 60  # post state every ~1 hour worth of Doge blocks
```

***

## Comparison

| Feature         | NEXUS-Dogecoin | Native Dogecoin | Wrapped DOGE (on ETH) |
| --------------- | -------------- | --------------- | --------------------- |
| Smart Contracts | ✅ Full WASM    | ❌               | ✅ (EVM)               |
| Self-Custody    | ✅              | ✅               | Usually ❌ (bridge)    |
| Cross-Chain     | 🔄 V2          | ❌               | ✅                     |
| DeFi            | ✅              | ❌               | ✅                     |
| Trust Required  | Trustless      | Native          | Usually bridge trust  |
| Block Time      | 1 min          | 1 min           | Ethereum (12s)        |

## Roadmap

### V1 (Live)

* ✅ P2PKH vaults with escape hatch
* ✅ ZK-STARK verification
* ✅ Fast deposits (\~6 min)
* ✅ Full WASM smart contracts
* ✅ Cross-contract calls

### V2 (Planned)

* 🔄 Unified liquidity with BTC/ZEC via intent exchange
* 🔄 DOGE/BTC/ZEC cross-chain swaps
* 🔄 Meme token liquidity pools