Demo App

Reference browser implementation of wallet-connected FlowVault flows, including user-state refresh and transaction feedback.

Purpose

The demo app proves production-like wallet behavior: users sign transactions in-wallet while SDK handles argument building, validation, and response normalization.

It also acts as an integration baseline to validate updates in wallet adapters, contract names, or SDK releases.

Reference implementations available:

These hosted examples are small, focused applications built against the FlowVault SDK. Use them to compare wallet behavior, strategy setup, deposit submission, and post-transaction feedback without reading the full frontend first.

SavingsSavings-Vault

Demonstrates a fixed savings strategy: deposit USDCx, lock the savings allocation for the configured block window, and keep the remainder available for withdrawal.

Open savings.flow-vault.dev FlowPayFlowPay

Demonstrates a payroll-style route: one deposit is split between locked savings, a recipient payout, and the sender's liquid balance before the wallet signs.

Open flowpay.flow-vault.dev

User Flow

Connect wallet and resolve STX sender address.
Set routing rules (lock and split).
Deposit USDCx with wallet signature.
Read vault state for balances and active rules.
Withdraw unlocked funds.

UI Responsibilities

Display active network and contract principal pair.
Prevent submits while wallet request is in-flight.
Show transaction ids and links to explorer for every write.
Refresh vault state after each successful confirmation.
Render locked and unlocked balances with micro-unit precision.

SDK Integration

const flowVault = new FlowVault({
  network,
  contractAddress,
  contractName,
  tokenContractAddress,
  tokenContractName,
  senderAddress: walletAddress,
  contractCallExecutor: async (call) => request("stx_callContract", {
    contract: call.contractAddress + "." + call.contractName,
    functionName: call.functionName,
    functionArgs: call.functionArgs,
    network: call.network,
    postConditionMode: "allow",
    postConditions: call.postConditions,
  }),
});

Validation Rules

Wallet address must be STX format (not BTC tb1 format).
lockUntilBlock must resolve to a future chain block when lockAmount > 0.
splitAddress is required when splitAmount > 0.