Quickstart

mkdir v1-legacy-integration
cd v1-legacy-integration
npm init -y
npm install riseworks-sdk ethers dotenv

RISE_ENVIRONMENT=prod          # or 'stg' for staging
WALLET_PRIVATE_KEY=0x...       # the delegate/owner wallet's private key
TEAM_RISE_ID=0x...             # your team or company's V1 RiseID
MANAGER_EMAIL=manager@example.com

// quickstart.js
require('dotenv').config();
const { RiseApiClient } = require('riseworks-sdk');
const { ethers } = require('ethers');

async function main() {
  const wallet = new ethers.Wallet(process.env.WALLET_PRIVATE_KEY);

  // jwtToken is required to construct a client, but any placeholder works —
  // updateToken() below replaces it with the real one.
  const client = new RiseApiClient({
    environment: process.env.RISE_ENVIRONMENT || 'prod',
    jwtToken: 'pending',
  });

  console.log('Requesting SIWE message...');
  const { data } = await client.v1Legacy.getSiwe({
    wallet: wallet.address,
    rise_id: process.env.TEAM_RISE_ID,
    impersonate: process.env.MANAGER_EMAIL,
  });

  console.log('Signing message with wallet', wallet.address);
  const signature = await wallet.signMessage(data.message);

  console.log('Verifying signature and exchanging for a JWT...');
  const { data: tokenData } = await client.v1Legacy.verifySiwe({
    wallet: wallet.address,
    message: data.message,
    signature,
  });

  client.updateToken(tokenData.token);
  console.log('Authenticated. Token expires in', tokenData.expires_in, 'seconds.\n');

  console.log('Fetching teams...');
  const teams = await client.v1Legacy.listTeams();
  console.log(`Found ${teams.data.length} team(s):`, teams.data.map((t) => t.riseId));
}

main().catch((err) => {
  console.error('Quickstart failed:', err.message);
  process.exit(1);
});

node quickstart.js

# add to .env
PAYEE_ID=us-xyz789abc123

// append to quickstart.js, inside main(), after the listTeams() call

console.log('\nSending a test payment...');
const receipt = await client.v1Legacy.pay(
  {
    wallet: wallet.address,
    rise_id: process.env.TEAM_RISE_ID,
    payee: process.env.PAYEE_ID,
    amount: 1000000, // $1.00, in micro-USD (1,000,000 = $1.00) — change before running against prod
    salt: Date.now(), // must be unique per payer+payee+amount — see Step 4 note below
  },
  process.env.WALLET_PRIVATE_KEY, // client has no configured signing key, so pass it explicitly
);

console.log('Payment sent. Transaction hash:', receipt.data.transactionHash);