Your first world

The world we are building

Five separate Blue documents, each with its own participants and rules, taken together forming Alice's world. Bob participates in some of them. The bank participates in another. The courier in another.

Step 1 — the shop

Start with a shop block.

Participants: Alice

State: business name, description, contact preferences, payment status

Operations: Alice can update her shop. Services may be invited later. Orders may be linked into it.

Timeline entry that triggers a change: Alice posts an Update Profile request to her owner channel.

Result: the shop document's state moves to the new profile, and the change is permanently recorded on Alice's timeline.

Step 2 — the order

Now add an order.

Participants: Alice, Bob, optionally Bob's agent

State: item, quantity, status, notes, expected amount

Operations: Bob can place or update the order. Alice can confirm or reject it. The order may trigger or link to a payment.

Timeline entry: Bob places the order via his buyer channel; Alice accepts via her seller channel.

Result: two timelines, one document, status moves placed → accepted.

Step 3 — the payment mandate

Bob wants his agent to buy safely. He creates a mandate block.

Participants: Bob, Bob's agent (e.g. OpenClaw), maybe a bank or payment operator

State: allowed payment source, boundaries, conditions, approval thresholds

Operations: the agent may only propose payments through the mandate. The proposal must satisfy the constraints. Actions outside the mandate are invalid.

Timeline entry: the agent posts a Propose Payment request through its agent channel; the mandate document validates it.

Result: a constrained, attributable agent flow that does not require giving the agent a card.

Step 4 — the PayNote

Attach a PayNote to the transaction.

Participants: Bob, Alice, the bank / guarantor, maybe delivery or verification participants

State: expected amount, secured, completed, reversed, conditions, delivery and review state

Operations: secure funds now. Complete payment later — only after conditions are satisfied. Reverse or cancel if rules allow.

Timeline entry: the bank posts a Secure Funds entry on its guarantor channel.

Result: money is part of the same explicit world as the order, the delivery, and the mandate.

Step 5 — delivery confirmation

Now a courier or verifier participates.

Participants: Alice, Bob, bank, courier

State: delivery status, confirmation status, timestamps

Operations: the courier can confirm delivery. That confirmation may unlock payment completion.

Timeline entry: the courier posts a Confirm Delivery entry on its courier channel; the PayNote sees it via composition and processes a Complete Payment step.

Result: the world reaches its terminal state with full attribution and a permanent record.

The world at a glance

What this world teaches

You now have a small but complete Blue world. Each block has participants, rules, state, and can reference or trigger others. That is Blue.

How to try it

You can approach the same world in three ways:

• build it by talking to Blink in MyOS
• build parts of it through the JavaScript SDK
• define the raw blocks in Blue / YAML