What the town manager sees every morning
Before we walk through a single contract, here's the Admin Console home screen. Multiple projects, multiple vendors, multiple statuses — all in one place. No spreadsheets, no email chains, no "can you send me that invoice again." Anything requiring action surfaces automatically as an alertPending ActionsCivic-Chain flags items that need admin attention: votes closing soon, WCRs awaiting approval, card pools running low. No action slips through the cracks because there's no inbox to check..
- In most small towns, this view doesn't exist. Admins track contracts across email threads, binders, and spreadsheets that no one else can read.
- Pending actions surface automatically. A WCR or closing vote doesn't get missed because there's no separate inbox to check.
- Every contract shown here is also visible — in real time — on the public Citizen Ledger. The admin and the resident are looking at the same record.
The town clerk posts a project solicitation
Harpswell's town manager needs pavement crack sealing on Route 123 before winter. She logs into the Admin Portal and creates a solicitation. Civic-Chain's Proposal EngineProposal EngineThe module that manages the full lifecycle of a solicitation: creation, public posting, vendor bid submissions, and voting. Replaces emailed RFPs and paper bid packets. publishes it instantly to the public ledger so any qualified vendor can see it, and so residents know a project is being considered.
- The solicitation is live on the public ledger immediately. No mailing list, no paper packets.
- The 80/20 payment split is locked in at posting. Vendors know exactly what they will receive and when.
- Residents are notified that a vote will open. The spending intention is public before money is committed.
Harpswell residents vote to approve the project
Any Harpswell resident can vote — from their phone, no account required. Civic-Chain uses geolocation votingGeolocation VotingThe resident's device confirms they are physically within town boundaries before their vote is counted. GPS coordinates are checked once and immediately discarded. No coordinates are ever stored. to confirm the voter is physically within town boundaries. Their exact coordinates are checked once and immediately discarded — only the pass/fail result is saved. No registration, no login, no stored location data.
- Residents voted directly on the spending decision. The town didn't hold a meeting or mail ballots.
- Location was verified without storing any GPS data. Privacy is built into the architecture, not bolted on.
- Live vote results are public. Anyone can watch the tally in real time. 87% approved — the project moves forward.
Bids close. The town awards the contract.
Three vendors submitted bids. Coastal Road Services came in at $17,200 — below budget. The town manager selects them in the Admin Portal. The moment she clicks "Award Contract," Civic-Chain generates a Smart Agreement RecordSmart Agreement Record (SAR)A tamper-proof record of the contract terms, vote outcome, and award decision that is anchored permanently on the XRP Ledger. Anyone can verify it exists and has not been altered. and anchors it to the XRP LedgerXRP Ledger (XRPL)A public blockchain that records transactions permanently. Once a record is written there, it cannot be changed or deleted. Civic-Chain uses it as a tamper-proof audit trail.. The contract is now on the public record before a single dollar moves.
- The contract terms — vendor, amount, scope, vote result — are permanently recorded on a public blockchain. No one can alter them after the fact.
- Any resident can look up hash A3F9C1D8... on the public XRP Ledger explorer right now and verify the contract exists exactly as posted.
- Coastal Road came in $1,300 under budget. That saving stays in the town's account automatically.
Coastal Road receives a project card on their phone
No wire transfer. No check in the mail. Within minutes of the contract award, Coastal Road's site supervisor opens the Vendor Portal and sees a virtual card loaded with $13,760 (the 80% upfront, net of Civic-Chain's fee). The card is provisioned to their phone via Apple Pay or Google Pay. It has an MCC lockMCC Lock (Merchant Category Code)A restriction built into the card that limits where it can be spent. For road maintenance, the card works at fuel stations, equipment rental, and construction supply merchants only. It will decline at a restaurant or hardware store that sells non-construction goods. — it can only be spent at fuel stations, equipment rental, and construction supply merchants. It cannot be used anywhere else.
- The contractor is funded and can start work today. No 30-day net terms. No invoice cycle.
- The MCC lock makes misuse structurally impossible — the card declines automatically at unauthorized merchants. No auditing required after the fact.
- Because vendors know they get paid same-day, they bid lower. The town already saved $1,300 on this contract alone.
The crew is on-site. Every card swipe is recorded.
Coastal Road's crew works for three days. The site supervisor taps his phone at the fuel station, the equipment rental yard, and the crack-seal material supplier. Every transaction is logged instantly in the Vendor Portal and visible to the Admin. There is no expense report to file, no receipt to photograph, no reconciliation meeting to schedule. The card transactions are the record.
- Every spend is categorized, timestamped, and associated with contract CRN-2026-HRP-0041 automatically.
- The town manager can see this in real time. No waiting for an invoice or end-of-month statement.
- Unspent balance ($4,545.50) returns to the town automatically when the card pool closes.
Job done. Residual payment released in one click.
Coastal Road's supervisor submits a Work Completion RecordWork Completion Record (WCR)A short digital form the vendor submits to confirm the job is done. It triggers the release of the 20% residual payment and is anchored on the XRPL alongside the payment hash. from the Vendor Portal. The town manager reviews and approves. Civic-Chain releases the $3,440 residual via Ripple Payments RailRipple Payments RailRipple's real-time payment infrastructure, operating in 51 markets. Payments settle in seconds rather than the 3-5 business days typical of ACH. Civic-Chain routes residual payments through Ripple Rail so vendors receive funds the same day the work is approved.. The money lands in the vendor's account in seconds, not days.
- Vendor received final payment in seconds. No invoice submitted. No 30-day wait. No check to cash.
- The WCR and payment hash are both anchored to the XRPL. A complete, verifiable record of the project now exists permanently on the public blockchain.
- Total paid to vendor: $13,214.50 (card spend) + $3,440 (residual) = $16,654.50. The town saved $1,845.50 against budget and recovered all unspent card balance.
Any resident can verify every dollar spent
Mary, a Harpswell taxpayer, hears about the Route 123 project from a neighbor. She opens the Citizen Portal on her phone — no login, no account. She can see every contract, every payment, and every transaction hash. She can click any hash and verify it independently on the public XRP Ledger. No one at the town hall can change what she sees. The record is on the blockchain.
- Every transaction in this project is publicly visible, permanently, with an independent blockchain reference. No FOIA request needed.
- The town came in $1,845.50 under budget. Residents can see that $545.50 in unspent card balance was returned to the town automatically.
- This is the same view available for every contract, every year. Accountability is not a report — it is the default state of the system.
That's the full Civic-Chain workflow
From solicitation to public ledger, a $17,200 road project ran start to finish with no paper invoices, no manual reconciliation, and a permanent public record of every dollar.