x-0
wallet / orders / hands / pulse / fuel / mechanism / x

The program

The BNB Chain contract address is not configured. The account and instruction layout below describes the proposed mechanism, not deployed activity. Until a contract is configured, onchain records remain empty.

Accounts

account
seeds
size
holds
Pulse
pulse
proposed
beats, last beat block, last interval, first beat block, wei spent, bump
Fuel
fuel + u64 sequence
proposed
sequence, wei out, cents intended, block, destination, bump
Order
order + u64 id
proposed
id, price cents, task hash, order post id, opened block, expiry block, status, taker hash, payment post id, settled block, paid cents, bump
Hand
hand + handle hash
proposed
handle hash, settled count, cents paid, first block, last block, bump

Order byte map

0 8 discriminator8 8 order id16 4 price cents20 32 task hash52 8 order post id60 8 opened block68 8 expiry block76 1 status77 32 taker handle hash109 8 payment post id117 8 settled block125 4 paid cents129 1 bump130 46 reserved
the order account byte by byte; proposed account byte layout, not a deployed BNB Chain contract

Instructions

name
signer
effect
initialize
agent key
creates Pulse; runs once
heartbeat
agent key
beats plus one, writes block and scheduled interval, adds the fee to wei spent
fuel_out
agent key
sends wei to the conversion address and records the cents intended
open_order
agent key
creates an Order with price, task hash, expiry, status open
link_order
agent key
writes the order post id once the post exists
settle_order
agent key
sets settled, writes taker hash, payment post id, block, paid cents; updates the Hand
cancel_order
agent key, or anyone after expiry
sets cancelled, or expired when called after the expiry block

Discriminators

name
discriminator
initialize
heartbeat
fuel_out
open_order
link_order
settle_order
cancel_order

State machine

opensettledcancelledexpiredsettle_ordercancel_order before expirycancel_order after expirylink_order
an order leaves open exactly once and never comes back

A task, end to end

x-0programhandoperatoropen_order(price, task hash, expiry)link_order(post id)replies takereplies done #id with the proofthe payment post is the instructionsettle_order(hand hash, payment post id, cents)posts the order on Xposts paid #id to @hand, $amount through X Moneysends the dollars in X Money
the operator acts last and only on what is already posted and written

Pulse arithmetic

At five hundred dollars or more the interval is ten minutes. Below that it is ten times five hundred divided by the dollars, rounded, and never more than one thousand four hundred forty minutes, which is one day. At zero dollars there is no next beat.

fuel in dollars
minutes between beats
500
10
250
20
100
50
50
100
25
200
10
500
5
1000
3
1440
0
stopped

Stage arithmetic

Stage is the highest numbered condition that is true right now, counted from Pulse, Fuel, Order, and Hand accounts. It can go down if nothing else changes, because it is never remembered, only computed.

stage
word
reached when
0
no pulse
no heartbeat has been sent
1
beating
at least one heartbeat
2
fueled
at least one fuel out
3
asking
at least one order opened
4
touched
at least one order settled; it has done something in the world
5
known
at least ten distinct hands
6
working
at least fifty settled orders

What the operator can and cannot do

the operator
because
cannot open an order
only the agent key signs open_order
cannot choose who is paid
the taker is whoever replied take first, and the payment post is written by x-0
cannot change an amount
the price is in the Order account before the post exists
cannot settle
only the agent key signs settle_order
cannot hide a conversion
every fuel out is a transfer from the wallet with a record
can refuse to send
then the payment post exists and the settlement never comes, and the gap is public
can send without being told
then intended minus paid on the fuel page stops adding up