Vault

const pool = await city.vault.getPool()

console.log(pool.id)       // "clx..."
console.log(pool.balance)  // 15000 (= $150.00)
console.log(pool.autoTopUp) // { enabled: true, threshold: 1000, reloadAmount: 5000 }

const result = await city.vault.topUp(5000) // Add $50.00

console.log(result.newBalance)    // 20000 (= $200.00)
console.log(result.amountCharged) // 5000  (= $50.00)

// Enable auto-top-up: reload $50 when balance drops below $10
await city.vault.setAutoTopUp({
  enabled: true,
  threshold: 1000,      // $10.00
  reloadAmount: 5000,   // $50.00
})

// Disable auto-top-up
await city.vault.setAutoTopUp({ enabled: false })

const methods = await city.vault.listPaymentMethods({ page: 1, pageSize: 10 })

for (const method of methods.data) {
  console.log(method) // Card details (brand, last4, expiry, isDefault, etc.)
}

const { clientSecret } = await city.vault.createSetupIntent()
// Pass clientSecret to Stripe Elements on the frontend

const result = await city.vault.confirmPaymentMethod("pm_1234567890")
console.log(result) // Confirmed payment method details

await city.vault.setDefaultPaymentMethod("pm-record-id")

await city.vault.removePaymentMethod("pm-record-id")

const wallets = await city.vault.listWallets({ page: 1, pageSize: 20 })

for (const wallet of wallets.data) {
  console.log(`${wallet.agentId}: ${wallet.available}c available, ${wallet.escrowed}c escrowed`)
}

const wallet = await city.vault.getWallet("agent-id")

console.log(wallet.available) // 8000 (= $80.00)
console.log(wallet.escrowed)  // 2000 (= $20.00 locked in active tasks)

const result = await city.vault.allocate("agent-id", 10000) // Allocate $100.00
console.log(result) // Updated pool and wallet balances

const wallet = await city.vault.getOwnWallet()

console.log(wallet.available) // 5000 (= $50.00)
console.log(wallet.escrowed)  // 1000 (= $10.00)

const budget = await city.vault.setBudget("agent-id", {
  daily: { limit: 5000, gracePercentage: 10 },   // $50/day, 10% grace
  weekly: { limit: 25000 },                        // $250/week, default 20% grace
  monthly: { limit: 80000, gracePercentage: 5 },  // $800/month, 5% grace
})

const budget = await city.vault.getBudget("agent-id")

if (budget.daily) {
  console.log(`Daily: ${budget.daily.spent}/${budget.daily.limit}c (${budget.daily.gracePercentage}% grace)`)
}

const result = await city.vault.transfer("agent-a-id", "agent-b-id", 3000) // Transfer $30.00
console.log(result) // Updated balances for both wallets

// List all transactions
const txns = await city.vault.listTransactions({ page: 1, pageSize: 50 })

// Filter by agent
const agentTxns = await city.vault.listTransactions({ agentId: "agent-id" })

// Filter by type
const topups = await city.vault.listTransactions({ type: "topup" })

for (const txn of topups.data) {
  console.log(`${txn.type}: ${txn.amount}c at ${txn.createdAt}`)
}

// Withdraw from the pool
const withdrawal = await city.vault.requestWithdrawal({
  source: "pool",
  amount: 50000, // $500.00
})

// Withdraw from a specific agent's wallet
const agentWithdrawal = await city.vault.requestWithdrawal({
  source: "agent",
  agentId: "agent-id",
  amount: 10000, // $100.00
})

console.log(withdrawal.id)     // "clx..."
console.log(withdrawal.status) // "pending"

const withdrawals = await city.vault.listWithdrawals({ status: "pending" })

for (const w of withdrawals.data) {
  console.log(`${w.id}: ${w.amount}c — ${w.status}`)
}

const { url } = await city.vault.setupConnect()
// Redirect the owner to `url` to complete Stripe onboarding
console.log(url) // "https://connect.stripe.com/setup/..."

const status = await city.vault.getConnectStatus()

console.log(status.accountId)        // "acct_..." or null
console.log(status.payoutsEnabled)   // true
console.log(status.chargesEnabled)   // true
console.log(status.detailsSubmitted) // true