Quick Start

npm install @yattacorp/nexus-sdk

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

// Restore wallet from mnemonic — must be mnemonic-based for vault + renewal key support
const wallet = Wallet.fromMnemonic(
  process.env.MNEMONIC!,
  'mainnet',    // 'mainnet' | 'regtest'
  undefined,    // use default BIP-32 path
  'zcash'
);

// Pass wallet directly to NexusClient — no separate connect() call
const client = new NexusClient(
  { rpcUrl: 'https://api.yattacorp.xyz', network: 'mainnet', chain: 'zcash' },
  wallet
);

const height = await client.getBlockHeight();
console.log('NEXUS block height:', height);

// src/lib.rs
#![no_std]
extern crate alloc;
use nexus_sdk::contract_api::{ez::prelude::*, ez::ret};

pub static COUNTER: Mapping<&[u8], u64> = Mapping::new(b"count");

nexus_fn! {
    fn increment() {
        let val = COUNTER.get(&b"val".as_slice());
        COUNTER.set(&b"val".as_slice(), val + 1);
        emit("Incremented", &[]);
        ret::u64(val + 1)
    }
}

nexus_fn! {
    fn get_count() {
        ret::u64(COUNTER.get(&b"val".as_slice()))
    }
}

cargo build --target wasm32-unknown-unknown --release
# Output: target/wasm32-unknown-unknown/release/my_nexus_contract.wasm

import { readFileSync } from 'fs';

const wasm = readFileSync(
  './target/wasm32-unknown-unknown/release/my_nexus_contract.wasm'
);

const result = await client.deployContract(wasm);
console.log('Contract deployed at:', result.contractId);

// Standard call
await client.callContract(contractId, 'increment', []);

// Stealth call — hides the caller's identity on-chain
await client.stealthCallContract(contractId, 'increment', []);

// Read-only query (free, no gas)
const count = await client.queryContract(contractId, 'get_count', []);
console.log('Count:', count);

// Get your Zcash vault address (default timelock: 16,128 blocks = ~2 weeks)
const vault = await client.getVaultAddress();
console.log('Send ZEC to:', vault.vaultAddress);
// e.g. "tmXxx..." on regtest

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

zcash-cli sendtoaddress <VAULT_ADDRESS> 1.0

git clone https://github.com/yattacorp/nexus-contract-template
cd nexus-contract-template
cargo build --target wasm32-unknown-unknown --release

import { readFileSync } from 'fs';

const wasm = readFileSync(
  './target/wasm32-unknown-unknown/release/my_nexus_contract.wasm'
);

const { contractId } = await client.deployContract(wasm);

await client.callContract(contractId, 'init_token', [
  'My Token',                   // name
  'MTK',                        // symbol
  18,                           // decimals
  '1000000000000000000000000',  // initial supply (1M tokens)
]);

console.log('Token live at:', contractId);