Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

core-stablecoin

Who it's for: Users in Ghana who want to hold, send, or use digital money that moves with the Ghana Cedi — and developers building payments or savings products denominated in local currency. Why it matters: cGHS is 100% fiat-backed and verifiable on-chain, giving users in Ghana a stable digital currency they can convert to and from mobile money without touching a bank.

core-stablecoin manages the cGHS stablecoin — the Ghana Cedi on-chain. It's deployed once per currency (BASE_CURRENCY env var). The same service handles XOF, KES, etc. as additional named deployments.

cGHS contract: 0x3126627A607E730E3eCF9BbfFD67fa18Deaab846

Route Groups

PrefixDescription
/depositFiat in → mint cGHS (Transakt gateway)
/withdrawBurn cGHS → fiat out (Transakt payout)
/oracleGHS/USD price push, factory oracles, conversion
/reservesKZG ZK proof-of-reserves
/webhookTransakt + wallet callbacks

Deposit Flow

Deposits go through Transakt — Shika's mobile money / bank transfer gateway partner:

POST /deposit
  → Transakt initiates collection (returns ref)
  → User pays via mobile money
  → Transakt POSTs /webhook/transakt on success
  → Service mints cGHS on-chain
  OR
POST /deposit/confirm   (manual trigger if webhook missed)

Cron — Oracle Push

Every 6 hours, the service automatically fetches the live GHS/USD rate and pushes it on-chain via Aggregator.updateAnswer(price) through the Shika agent wallet. No manual oracle push needed in normal operations.

Token Specs

PropertyValue
NameShika Ghana Cedi
SymbolcGHS
Decimals6
ChainBase Mainnet
Backing100% fiat-backed, verified by KZG ZK proofs