Frequently Asked Questions

Is GhostReceipt custodial?

No. Proof generation and sensitive witness data stay in the client-side flow. Your private keys and transaction details never leave your browser.

Do I need to connect a wallet?

No. You only need to provide the transaction hash and your claim parameters. No wallet connection required.

Do I need API keys?

No. API key entry is optional advanced mode only. The default flow works without any API keys.

Can this run without a credit card?

Yes. Local setup and baseline flow are designed for no-card operation using free-tier/public provider paths.

What does the verifier see?

Only proof-related public claims and redacted receipt output. They cannot see the actual transaction amount, exact timestamp, sender address, receiver address, or transaction hash.

How does zero-knowledge proof work?

GhostReceipt uses Groth16 zk-SNARKs to prove statements about your transaction without revealing the underlying data. The proof is generated in your browser using Circom circuits and snarkjs.

Which blockchains are supported?

Currently Bitcoin, Ethereum (native ETH + ERC-20 USDC), and Solana (native SOL).

Are stablecoins supported?

Yes. Ethereum supports both native ETH and ERC-20 USDC claim modes through the same oracle fetch flow.

Can receipts be forged?

No. Each receipt includes an oracle signature over canonical blockchain data. The zero-knowledge proof cryptographically binds your claim to the oracle-signed transaction data.

How does fail-safe routing work?

GhostReceipt calls /api/oracle/* first. If that route is unavailable (network failure, 404/405, or 5xx), it can retry against an optional edge backup base configured by the operator. Normal 4xx responses (including rate limits) are returned directly and do not trigger backup retries.

What does a verified receipt prove today?

It proves your claim satisfies the circuit against oracle-signed canonical transaction facts. It does not remove trust in the current single oracle operator and upstream data providers.

What do validation labels mean?

GhostReceipt shows validation strength as passive metadata, with no extra clicks required:

• consensus_verified: primary and peer providers agreed before signing.
• single_source_fallback: peer was unavailable, and best-effort mode allowed signing with the primary source.
• single_source_only: consensus checks were off or no peer path was configured.

For Bitcoin, what does the amount represent?

Bitcoin valueAtomic currently maps to total transaction output value (sum(vout) / output_total), not recipient-specific net received value. For multi-output transactions, treat it as tx-level evidence.

How long does proof generation take?

Typically under 60 seconds on modern devices. The process includes fetching transaction data, validating constraints, and generating the zero-knowledge proof in your browser.

Can I use this for business/compliance?

Yes. GhostReceipt is designed for freelancers, merchants, accounting teams, and DAO contributors who need verifiable payment evidence without exposing sensitive financial data.