Skip to content
FSCO Docs

Stablecoin

Overview

Section titled “Overview”

The Stablecoin module lets you issue and manage fiat-backed tokens through an auditable attestation workflow. Minting and burning are permissioned and tied to documented evidence (e.g. bank wires), enabling institutions to tokenize off-chain assets with confidence. All smart contracts are deployed through FSCO and operate across any EVM-compatible chain.

Key Features

Section titled “Key Features”
  • Token Deployment: Deploy fully-managed ERC-20 stablecoins backed by real-world currencies
  • Attestation-Backed Minting & Burning: Require human-verifiable steps before mint or burn
  • Multi-Wallet Role Control: Assign submitters, verifiers, minters, and admins
  • Document Upload: Attach wire receipts, PDFs, or audit letters to each attestation
  • Live Supply Tracking: View total minted, burned, and circulating in real-time

How It Works

Section titled “How It Works”

1. Deploy the Stablecoin

Section titled “1. Deploy the Stablecoin”

Use the /deploy endpoint to initialize a new fiat-backed token. This deploys token, attestation, and factory contracts and returns a stablecoinId.

➡ Deploy a Stablecoin

2. Submit a Mint or Burn Attestation

Section titled “2. Submit a Mint or Burn Attestation”

Minting and burning is not direct. Instead, you submit an attestation that documents why the change should happen, who is executing it, and any references to off-chain events (e.g. transaction references, wire dates).

➡ Submit an Attestation

3. Upload Supporting Documents

Section titled “3. Upload Supporting Documents”

If your attestation includes proof of funds or approvals, upload files and associate them via blobId.

➡ Upload Attestation Document

4. Verify the Attestation

Section titled “4. Verify the Attestation”

Another wallet (typically a verifier or admin) must review and approve or reject the attestation.

➡ Verify or Reject an Attestation

5. Execute the Attestation

Section titled “5. Execute the Attestation”

Once verified, any authorized wallet can execute the attestation to perform the mint or burn on-chain.

➡ Execute an Attestation

6. Track Attestations & Supply

Section titled “6. Track Attestations & Supply”

You can fetch a list of all attestations, inspect details of one, or retrieve full stablecoin stats including total supply and roles.

7. Assign or Remove Roles

Section titled “7. Assign or Remove Roles”

Stablecoin permissions are scoped by roles like SUBMITTER_ROLE, VERIFIER_ROLE, MINTER_ROLE, and more. You can assign or revoke these for any wallet using FSCO’s API.

➡ Manage Roles

Common Use Cases

Section titled “Common Use Cases”
  • Fiat-backed Token Issuance: Launch and control tokenized national currencies
  • Enterprise Mint Controls: Require manual oversight of every mint event
  • Regulated Institutions: Maintain full audit logs of every balance change
  • Cross-Chain Supply Coordination: Use one token with deployments on multiple chains

API Reference

Section titled “API Reference”

See the Stablecoin API Reference for full request and response schemas.

Best Practices

Section titled “Best Practices”
  • Always store stablecoinId and attestationId values securely
  • Assign distinct wallets for submitter vs verifier roles for better separation of duties
  • Track and validate all uploaded documents in your external systems
  • Use descriptive transactionReference and notes to improve audit clarity

Limitations

Section titled “Limitations”
  • Mint and burn flows require human involvement; this module prioritizes trust and traceability over speed
  • Only EVM-compatible chains are supported
  • Only PDF, image, or plain file formats are currently accepted for attestations