Dexsta documentation

curl -sS "$HOST/api/health" | jq .
curl -sS "$HOST/api/xft?id=1" | jq .
curl -sS "$HOST/api/xft?label=usa%20politics" | jq .
curl -sS "$HOST/api/xft/user?owner=$PRINCIPAL" | jq .
curl -sS "$HOST/api/prices?include=crypto&symbols=ICP" | jq .

sh -ci "$(curl -fsSL https://internetcomputer.org/install.sh)"
# or: brew install dfinity/dfx/dfx
dfx --version

dfx identity new dexsta_agent
dfx identity use dexsta_agent
dfx identity get-principal     # paste into Operators UI
dfx ledger account-id          # ICP ledger account hex
dfx ledger balance --network local

# List all local identities
for name in $(dfx identity list); do
  printf "%-28s %s\n" "$name" "$(dfx identity get-principal --identity "$name")"
done

export XFT="$(dfx canister id xft)"
export OP="$(dfx canister id operator)"
export AGENT="$(dfx identity get-principal --identity dexsta_agent)"
export LABEL_ID=1
export LICENSE_ID=42

# Owner transfers type-5 license to agent, then:
dfx canister call "$OP" setOperatorWithLicense "(
  principal \"$AGENT\",
  principal \"$XFT\",
  $LABEL_ID : nat,
  $LICENSE_ID : nat,
  false,
  record {
    can_withdraw = false;
    can_swap = true;
    can_lock = true;
    can_set_oracles = true;
    max_withdraw_amount = null;
    expires_at = null;
  }
)"

dfx canister call "$XFT" bagOf "($LABEL_ID : nat)"
# → export BAG=...

dfx identity use dexsta_agent
export BAG="<from-bagOf>"
export AMOUNT_E8S=10000000   # 0.1 ICP
export ICP_LEDGER="$(dfx canister id icp_ledger 2>/dev/null || echo ryjl3-tyaaa-aaaaa-aaaba-cai)"

dfx canister call "$BAG" getDabPricingSnapshot
dfx canister call "$BAG" quoteDabBuyDetailed "($AMOUNT_E8S : nat)"

# Approve bag, then buy
dfx canister call "$ICP_LEDGER" icrc2_approve "(
  record {
    fee = null; memo = null; from_subaccount = null;
    created_at_time = null; expected_allowance = null; expires_at = null;
    amount = $((AMOUNT_E8S + 10000)) : nat;
    spender = record { owner = principal \"$BAG\"; subaccount = null };
  }
)"

dfx canister call "$BAG" buyDabTokens "(
  principal \"$(dfx identity get-principal)\",
  $AMOUNT_E8S : nat,
  principal \"$(dfx canister id xft)\",
  0 : nat,
  0 : nat
)"

dfx canister call "$BAG" redeemDabTokens "(
  principal \"$(dfx identity get-principal)\",
  50 : nat,
  0 : nat
)"

import { getAgentSearchSnapshot } from "@/lib/search-ads";
import { listOwnedXfts } from "@/lib/portfolio";

// Keyword demand + bag DAB signals
const snap = await getAgentSearchSnapshot("seattle coupons");
// snap.research.bag, totalClicks, totalDabPaidE8s, buySignalScore, …

// Portfolio (canister getUserXfts + hydrate)
const { cards } = await listOwnedXfts(principalText);