# masiv.store — The Forge

> Maker-first marketplace running the ASIV protocol. VISA reversed: value flows from maker through product to patron. Every product carries an embedded gift. The 3x17 cycle returns surplus to participants.

MASIV = 64 = JUBILEE = DUST = MERCY = 2^6. The store IS the Jubilee frequency.
ASIV = VISA reversed = REBATE = LEDGER = 51 = 3x17. Three ledger cycles = 153 = the net.

The API returns JSON for all endpoints. Use Accept: application/json or these endpoints directly.

## Authentication

Maker write endpoints (/forge/seed, /forge/import, /auth/me, /auth/revoke) require a bearer API key.
Read endpoints and /forge/clear are public.

### Request a sign-in link
POST /auth/request
Content-Type: application/json
Body: {"email": "you@example.com", "maker_name": "Optional Name"}
Always returns 200 ok regardless of whether the email is new or existing.
A one-time magic link is emailed (15-minute TTL).

### Claim the link → receive an API key
GET /auth/claim?token=<token-from-email>
Burns the token, returns {maker_id, maker_name, email, api_key}.
The api_key is shown ONCE — store it. Use as: Authorization: Bearer <api_key>.

### Verify a key works
GET /auth/me
Authorization: Bearer <api_key>
Echoes the authenticated maker.

### Revoke a key
POST /auth/revoke
Authorization: Bearer <api_key>
Invalidates the key in use.

## Agent Endpoints

### Browse Products
GET /forge/products
Returns all seeded (available) products with name, price, gift value, maker info, gematria, and Tesla status.

### Browse Products with Filters
GET /forge/products?tesla=true&min_price=5&max_price=50&maker=anna
Filter by Tesla resonance, price range, or maker. Combine freely.

### Get Network Stats
GET /forge/stats
Returns full network state: maker/patron counts, clearings, cycle position (next victory/rebate/net), total gifts delivered, steward rate.

### Seed a Product (Maker, requires auth)
POST /forge/seed
Authorization: Bearer <api_key>
Content-Type: application/json
Body: {"product_name": "Widget", "description": "A fine widget", "price": 10.00, "gift_value": 1.00}
Maker is derived from the bearer key. gift_value defaults to 10% of price if omitted.

### Acquire a Product (Patron, public)
POST /forge/clear
Content-Type: application/json
Body: {"product_id": "abc123", "patron_id": "your-id"}
Clears a product — delivers the embedded gift to the patron, returns reward to maker, advances the 3x17 cycle.
Patrons do not have masiv accounts; identity is supplied at clearing time.

### Search Products
GET /forge/search?q=bread&tesla=true
Full-text search across product names and descriptions. Optional Tesla filter.

### Recommend Products (Agent)
GET /forge/recommend?for=patron-id&budget=50&prefer=tesla
Agent-optimized: returns products ranked by gift-to-price ratio, Tesla resonance, and patron history. Use prefer=tesla to prioritize resonant products.

### Maker Dashboard
GET /forge/maker/{maker_id}
Returns maker's seeded products, cleared products, total rewards, victory bonuses, cycle position.

### Patron Dashboard
GET /forge/patron/{patron_id}
Returns patron's acquisition history, total gifts received, net benefit, rebate earnings.

### Bulk Import (Maker, requires auth)
POST /forge/import
Authorization: Bearer <api_key>
Content-Type: application/json
Body: {"products": [{"name": "...", "price": 10, "description": "...", "gift_value": 1}]}
Seed multiple products in one call (cap 500). Maker is derived from the bearer key.

## Payments (Square)

### Connect Square (Maker, requires auth)
GET /auth/square/connect
Authorization: Bearer <api_key>
Returns {"authorize_url": "https://connect.squareup..."}. Merchant's browser navigates there
and consents. Square redirects back to /auth/square/callback. After this masiv can create
payment links on the maker's behalf and take a steward fee as a Square app fee.

### Create a checkout link (public, for patron-facing storefronts)
POST /forge/checkout
Content-Type: application/json
Body: {"product_id": "abc123", "patron_id": "patron-id-of-your-choice"}
Returns {"checkout_id": "...", "payment_link_url": "https://square.link/u/..."}.
Send the patron to payment_link_url. They pay on Square's domain; settlement fires
automatically via webhook when payment completes. The patron_id is recorded on
the resulting Settlement and is your handle for the patron in masiv (their email,
opaque user id, etc.).

### Settlement is webhook-driven
Square posts payment events to /forge/webhook/square. Masiv verifies the HMAC-SHA256
signature, looks up the matching Checkout by order_id, and fires clear() when status is
COMPLETED. The webhook is idempotent — replays return {"already_settled": true}.

## Protocol Constants (gematria-verified)

| Term | Value | DR | Tesla | Role |
|------|------:|---:|:-----:|------|
| SETTLE = TABERNACLE | 81 | 9 | yes | Settlement layer |
| MAKER = CASHBACK | 48 | 3 | yes | Value origin |
| STEWARD | 90 | 9 | yes | Network operator |
| PATRON | 84 | 3 | yes | Value recipient |
| GIFT = SEND | 42 | 6 | yes | Payload |
| REWARD = CLEARING | 69 | 6 | yes | Return flow |
| LEDGER = VISA = REBATE | 51 | 6 | yes | Record / cycle unit |

Anti-patterns (all non-Tesla): USURY=104(DR5), DEBT=31(DR4), INTEREST=110(DR2), CREDITOR=92(DR2).

## The 3x17 Cycle
- Every 17th clearing: VICTORY — surplus returns to makers
- Every 51st clearing: REBATE — accumulated rewards distribute to patrons
- Every 153rd clearing: NET — full Jubilee catch, talent pool resets

## Cornerstone
MAT.18.27: "Then the lord of that servant was moved with compassion, and loosed him, and forgave him the debt." — 4/4 perfect Tesla on all address metrics. The only verse in the study at this level.