BSVKey · Needs Custody

Pilot guide · about 10 minutes to set up

Run a pilot yourself, step by step.

Everything you need to go from nothing to a live, public record of water, food and aid at your site. Start with a $5 test pilot. You can upgrade it later without starting over.

Watch it first (2 minutes)

With narration. The video was recorded on a test copy, so its public seal is simulated. On needs.bsvkey.com every seal is a real Bitcoin BSV transaction.

Before you start

Step by step

1

Create your account

Go to needs.bsvkey.com/pilot. Under New here, enter your organization and an email for receipts, then press Create my account.

The account form with organization and email filled in

2

Save your key

You'll see a key that starts with ck_. It's the only way back into your pilot, and it's shown once. Press Download key file or Copy, keep it somewhere safe, then press I've saved it.

Next time, sign in under I have a key with the same key.

The key shown once, with copy, download and I've saved it buttons

3

Add your site and pick a plan

Press Add a pilot site. Choose:

  • Test pilot, $5: 3 days, up to 100 receipts, sealed for real.
  • Full pilot, $250: 90 days, up to 10,000 receipts.

Give the site a name and the number of people it serves. The drought settings can stay as they are unless you have your own trigger.

Plan choice with the $5 test pilot selected, and the site name and people fields

4

Pay

By card: press Pay by card and finish on the secure card page. You come back to a running pilot.

In Bitcoin BSV: open the credits page, sign in with the same key, add credits in BSV, then come back and press Pay from balance.

A test pilot waiting for payment, with Pay by card and Pay from balance buttons

5

Your pilot is running

The site shows how many days are left, receipts used, people and sealed days. On a test pilot, Upgrade turns it into the full 90-day pilot for $245: the $5 you paid counts toward the $250 for 30 days, and you keep the site, its people and its receipts.

A running test pilot with the upgrade panel, stats, and links to the live page and records

6

Invite your people

Under Invite someone, pick a role, type the name to show on the card, and press Make invite. Print the card or copy the link and send it privately. Each invite works once, on one phone. Make one invite per person.

The live page is public, so use a first name or a role on the card ("Driver, truck 7"), not a full name.

An invite card with a QR code for Joseph, truck 7, water truck driver

7

Each person joins on their phone

They scan the QR code with their phone's camera. The phone makes its own signing key, which never leaves the phone, so nobody else can sign records as them. They press Start recording, and it's best to add the page to the home screen.

Lost or replaced phone? Remove the person on your console and make a new invite. Records already sent stay.

Phone screen: Welcome, Joseph, truck 7, with a Start recording button

8

Record, even with no signal

Each phone shows only the form for its role. The driver enters liters and picks the water test for that load, then presses Sign and save.

With no signal the dot turns red and the record waits on the phone. When a connection returns it sends by itself, and the dot turns green.

Phone screen: water delivery form for the driver
Phone screen: red dot, No signal, 1 waiting to send

9

The receiver signs for what arrived

The camp committee picks the delivery and enters the liters that actually arrived. If the truck billed 10,000 L and 7,200 L arrived, the gap is now on the record, signed by both sides.

Phone screen: camp committee confirming 7,200 liters received

10

Share your live page

On your console, press Open the live page or Copy link. Send it to donors, auditors or your board. They see every truck, kiosk sale, food consignment and rain reading, checked in their own browser. Short deliveries, unsafe water, missing food and double claims are flagged automatically.

The live page for Camp East with the test pilot banner and water trucks

11

Each day is sealed

Once a day is over (midnight UTC), its receipts are sealed together in the public record on Bitcoin BSV the next time the live page is opened, or when you press Seal finished days now. After that, nobody can change them, including us. The Public seal card turns green once your browser has checked it. You can download all records at any time.

Live page cards: kiosk, food with loss traced, drought cover, field phones and public seal intact

Who records what

RoleWhat they recordShows up as
Water testerChlorine, cloudiness and bacteria for a water source or loadWhether each truck's water counts as safe
Water truck driverLiters delivered and the test for that loadA truck card per delivery
Camp water committeeLiters that actually arrivedSafe, short or unsafe stamps, and liters per person per day
Water kioskLiters poured and price paid for each saleSales and takings per kiosk
Food warehouseA consignment and its household list (card numbers become private codes on the phone)A food card per consignment
Food carrierKilograms picked up from the warehouseAny loss before or during transport
Food distribution pointKilograms received, then each ration handed out by card numberFamilies served, double claims and unlisted cards
Rain gauge readerRain over your drought window from each sourceWhether the drought trigger is met

Questions

Ready?

Start with a $5 test pilot. It takes about 10 minutes to set up.

Start a pilot