Use Your Exported Key

A Chipi wallet is self-custodial: only you can authorize transactions, and Chipi holds no key. For users who want full sovereignty, the wallet can export the owner private key (Security → Self-custody → Export private key). This page is for the developer who exported it and wants to use it from code — e.g. a script or backend — while still using the app normally.

The exported key can move all your funds. Anyone who gets it can drain your wallet, and no one (not even Chipi) can recover or revoke it. Never paste it into a website, never share it, never commit it to a repo. Treat it like cash.

The one thing to know first

A Chipi wallet is a SHHH smart account (account abstraction), not a plain EOA like a MetaMask account. Its __validate__ is disabled on purpose (shhh-wallet-cairo:src/account.cairo panics with 'SHHH: __validate__ disabled'), so the standard starknet.js path throws:

// ❌ Throws `SHHH: __validate__ disabled` — direct invokes are turned off.
const acct = new Account(provider, MY_ADDRESS, MY_PRIVATE_KEY);
await acct.execute(calls);

Instead you sign an OutsideExecution and submit it through execute_from_outside_v2. Your exported key signs; the transaction can be paid by anyone (you or a relayer), because the OE is permissionless.

Option A — Self-sovereign (no Chipi servers, you pay gas)

You sign with your exported key, then submit the signed OE from any funded Starknet account you control. Chipi is not in the loop — this is what makes self-custody verifiable. In TypeScript, the ShhhAccount adapter wraps the whole flow so it reads like starknet.js. In Python, compose the same primitives directly.

import { Account, RpcProvider, CallData } from "starknet";
import { ShhhAccount, submitViaAccount } from "@chipi-stack/backend";

const provider = new RpcProvider({ nodeUrl: RPC });

// A funded account that only pays gas — it never sees your owner key.
const relayer = new Account(provider, RELAYER_ADDRESS, RELAYER_PRIVATE_KEY);

const account = new ShhhAccount(provider, SHHH_ADDRESS, EXPORTED_PRIVATE_KEY, {
  submit: submitViaAccount(relayer),
});

// Example: send 1 USDC (native USDC, 6 decimals).
const USDC = "0x033068f6539f8e6e6b131e6b2b814e6c34a5224bc66947c47dab9dfee93b35fb";
const calls = [
  { contractAddress: USDC, entrypoint: "transfer", calldata: CallData.compile([RECIPIENT, "1000000", "0"]) },
];

const { transactionHash } = await account.execute(calls);
await provider.waitForTransaction(transactionHash);

import time
from chipi_sdk.shhh import (
    build_outside_execution,
    compute_oe_hash,
    build_stark_envelope,
    serialize_execute_from_outside_v2_calldata,
    ANY_CALLER_FELT,
)

SHHH_ADDRESS = "0x..."          # your account address
EXPORTED_PRIVATE_KEY = "0x..."  # the exported STARK key
SN_MAIN = "0x534e5f4d41494e"    # Starknet mainnet chain id

# Example: send 1 USDC (native USDC, 6 decimals).
USDC = "0x033068f6539f8e6e6b131e6b2b814e6c34a5224bc66947c47dab9dfee93b35fb"
calls = [{"to": USDC, "selector": "transfer", "calldata": [RECIPIENT, 1_000_000, 0]}]

oe = build_outside_execution(nonce=hex(int(time.time() * 1000)), calls=calls, caller=ANY_CALLER_FELT)
message_hash = compute_oe_hash(oe, SHHH_ADDRESS, SN_MAIN)
signature = build_stark_envelope(private_key=EXPORTED_PRIVATE_KEY, message_hash=message_hash, owner_index=0)
calldata = serialize_execute_from_outside_v2_calldata(outside_execution=oe, signature=signature)

# Submit `execute_from_outside_v2(calldata)` on SHHH_ADDRESS from any funded
# account (starknet.py Account.execute) — it only pays gas, it is not the signer.

Option B — Gasless, via Chipi’s paymaster

Same signing, but hand the serialized calldata to Chipi’s relayer so you don’t fund a gas account. You still hold the key; Chipi only relays.

// After producing `calldata` (above):
const res = await fetch("https://api.chipipay.com/v1/transactions/execute-sponsored-raw", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "<your pk_ key>",
    "Authorization": "Bearer <your JWT>",
  },
  body: JSON.stringify({ accountAddress: SHHH_ADDRESS, calldata, signerKind: "STARK" }),
});
const { transactionHash } = await res.json();

Notes

ownerIndex 0 is your primary owner (the exported key). Devices you added later are other owners with their own non-extractable passkeys; exporting doesn’t touch them.
Additive, not destructive. Using the key from code doesn’t disable the app — you can keep using Face ID in the wallet and your key in code at the same time, like MetaMask.
Mainnet only. Use the mainnet chain id and native USDC (0x033068…b35fb, not USDC.e).
Replay protection is per-nonce; reusing a nonce reverts with SRC9: duplicate nonce. The ShhhAccount adapter generates a fresh nonce per call.
If you ever suspect the key leaked, move your funds to a fresh wallet — there is no revoke for a raw key.

Gasless Wallets

Bill Payments

AI API

Gift Cards

Billing & Credits

Use Your Exported Key

The one thing to know first

Option A — Self-sovereign (no Chipi servers, you pay gas)

Option B — Gasless, via Chipi’s paymaster

Notes

​The one thing to know first

​Option A — Self-sovereign (no Chipi servers, you pay gas)

​Option B — Gasless, via Chipi’s paymaster

​Notes

The one thing to know first

Option A — Self-sovereign (no Chipi servers, you pay gas)

Option B — Gasless, via Chipi’s paymaster

Notes