@ixo/decision-oracle 0.2.2 → 0.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/dist/lib/email/template.js +1 -1
- package/dist/lib/email/template.js.map +1 -1
- package/dist/lib/payments/gate.js +2 -2
- package/dist/lib/payments/gate.js.map +1 -1
- package/dist/lib/payments/review-billing.js +1 -1
- package/dist/lib/payments/review-billing.js.map +1 -1
- package/dist/lib/register.js +1 -1
- package/dist/lib/register.js.map +1 -1
- package/dist/routes/v1/api/openapi.gen.d.ts.map +1 -1
- package/dist/routes/v1/api/openapi.gen.js +1 -1
- package/dist/routes/v1/api/openapi.gen.js.map +1 -1
- package/docs/api.md +2 -2
- package/docs/guide.md +1 -1
- package/openapi/decision-api.yaml +8 -8
- package/package.json +1 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"openapi.gen.js","sourceRoot":"","sources":["../../../../src/routes/v1/api/openapi.gen.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,iGAAiG;AACjG,sEAAsE;AAEtE,mGAAmG;AACnG,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAA4B,IAAI,CAAC,KAAK,CAAC
|
|
1
|
+
{"version":3,"file":"openapi.gen.js","sourceRoot":"","sources":["../../../../src/routes/v1/api/openapi.gen.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,iGAAiG;AACjG,sEAAsE;AAEtE,mGAAmG;AACnG,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAA4B,IAAI,CAAC,KAAK,CAAC,+gkXAA+gkX,CAAC,CAAC"}
|
package/docs/api.md
CHANGED
|
@@ -1582,7 +1582,7 @@ once deployed. Every value is validated by Zod at isolate start, so a bad env fa
|
|
|
1582
1582
|
| `EARNINGS_ADDRESS` | vars | unset | Where your earnings for decisions land in PAY and USDC on IXO: your own `ixo1…` account, sent as each offer's `payTo` (the facilitator checks it, never picks one). Checked at start, checksum included. Needed only when IXO's plan for the oracle takes PAY (the engine's `GET /v1/oracles/me` `accepts` holds `upay`; KV-cached 5 min): unset then ⇒ new x402 submits answer `503 SOURCE_PAUSED { reason: payments-disabled }`. A plan without PAY (card and/or USDC on Base) sends no ixo-pay terms and never reads it; a plan the engine cannot tell is the same 503 |
|
|
1583
1583
|
| `EARNINGS_BASE_WALLET` | vars | unset | Your Base wallet (`0x…`) for USDC on Base. Unset ⇒ that way to pay is not offered |
|
|
1584
1584
|
| `BILLING_ENGINE_URL` | vars | unset | Charge lookups and the spend figures on `/v1/api/me`. No trailing slash |
|
|
1585
|
-
| `CONSOLE_URL` | vars | unset | The Decision Console — every error's `docsUrl`, the 402's `fundingUrl`, and every email link (the `balance.low` email's is `<CONSOLE_URL>/credits`). Unset ⇒ the API lane's emails are logged skips. No trailing slash |
|
|
1585
|
+
| `CONSOLE_URL` | vars | unset | The Decision Console — every error's `docsUrl`, the 402's `fundingUrl`, and every email link (the `balance.low` email's is `<CONSOLE_URL>/billing/credits`). Unset ⇒ the API lane's emails are logged skips. No trailing slash |
|
|
1586
1586
|
| `AUTH_HUB_URL` | vars | per `IXO_NETWORK` (`https://dev.auth.ixo.earth`, `https://test.auth.ixo.earth`, `https://auth.ixo.earth`) | IXO AuthHub, the OAuth server of `/v1/mcp`: the protected-resource metadata's `authorization_servers`, the exact `iss` of an access token (its JWKS at `<url>/.well-known/jwks.json`), the approve link's host, and the one `did:web` (`did:web:<its host>`) the approvals back-channel accepts. Set it only for a local AuthHub. No trailing slash |
|
|
1587
1587
|
| `ORACLE_ADMIN_DIDS` | vars | unset | Comma-separated `did:ixo` admins of this oracle — the oracle's operator's own people — allowed on `GET /v1/admin/status` and `/v1/api/admin/*`. Unset ⇒ nobody |
|
|
1588
1588
|
| `STATUS_READER_DIDS` | vars | unset | Comma-separated DIDs of any method (`did:web:…`, `did:ixo:…`, each checked as `did:<method>:<id>`) allowed to read `GET /v1/admin/status` and nothing else — for a monitoring service, e.g. your decision engine's status board, identified by its DID. Kept apart from `ORACLE_ADMIN_DIDS` so a monitor is never made an operator. Unset ⇒ nobody |
|
|
@@ -2069,7 +2069,7 @@ receivers de-duplicate on `Oracle-Event-Id`. An erased row stays erased and goes
|
|
|
2069
2069
|
minutes) reads each active source's payer balance against its `refillFloorCents`. The first read
|
|
2070
2070
|
below the floor sends one `balance.low` webhook (`{ sourceId, balanceCents, floorCents }`) and one
|
|
2071
2071
|
email to the source's `contactEmail`: the source's name, the balance and the floor as dollars, and
|
|
2072
|
-
an "Add credits" link to `${CONSOLE_URL}/credits`. The webhook goes once per crossing (a recovery
|
|
2072
|
+
an "Add credits" link to `${CONSOLE_URL}/billing/credits`. The webhook goes once per crossing (a recovery
|
|
2073
2073
|
above the floor re-arms it). The email goes once per UTC day while the balance stays under the
|
|
2074
2074
|
floor (`notice_balance_low:<sourceId>:<yyyy-mm-dd>`): still low tomorrow is a new email, a balance
|
|
2075
2075
|
bobbing around its floor within a day is one, and a send that fails is retried on the next check.
|
package/docs/guide.md
CHANGED
|
@@ -1280,7 +1280,7 @@ claim is ever blocked on one.
|
|
|
1280
1280
|
facilitator configured, the balance watch (every 5 minutes) sends a `balance.low` webhook the
|
|
1281
1281
|
first time the payer's balance drops below it, and emails the source's `contactEmail` once per UTC
|
|
1282
1282
|
day while it stays below (a send that fails is retried on the next check): the balance against the floor in dollars, and an "Add credits" link to your console's
|
|
1283
|
-
Credits page (`CONSOLE_URL/credits`). Without `CONSOLE_URL` or a sender, the email is a logged skip.
|
|
1283
|
+
Credits page (`CONSOLE_URL/billing/credits`). Without `CONSOLE_URL` or a sender, the email is a logged skip.
|
|
1284
1284
|
|
|
1285
1285
|
**Uptime and status.** Point your uptime monitor (Sentry Uptime, or any HTTP checker, every
|
|
1286
1286
|
minute) at `GET /health/ready`, not `/health`: `/health` only proves the worker boots, while
|
|
@@ -335,10 +335,10 @@ info:
|
|
|
335
335
|
|
|
336
336
|
|
|
337
337
|
**Changes in 1.19.0.** No wire change. The CLI gains the console's onboarding steps:
|
|
338
|
-
`decision-oracle org create` (an organisation entity, idempotent by name), `decision-oracle api
|
|
339
|
-
link <sourceId>` (signs the organisation's link, PUTs it to the engine and calls `POST
|
|
340
|
-
/v1/api/sources/{sourceId}/company/sync`: `pending-link` → `active`), `decision-oracle org
|
|
341
|
-
and `decision-oracle logout`.
|
|
338
|
+
`decision-oracle org create` (an organisation entity, idempotent by name), `decision-oracle api
|
|
339
|
+
source link <sourceId>` (signs the organisation's link, PUTs it to the engine and calls `POST
|
|
340
|
+
/v1/api/sources/{sourceId}/company/sync`: `pending-link` → `active`), `decision-oracle org
|
|
341
|
+
balance` and `decision-oracle logout`.
|
|
342
342
|
|
|
343
343
|
|
|
344
344
|
**Changes in 1.20.0.** Additive: `ClaimRecord.decision.erroredFacts` and
|
|
@@ -7754,14 +7754,14 @@ components:
|
|
|
7754
7754
|
maxTimeoutSeconds: 120
|
|
7755
7755
|
extra:
|
|
7756
7756
|
nonce: 7c1e2a4b-9d3f-4e8a-b6c5-2f1d0e9a8b7c
|
|
7757
|
-
fundingUrl: https://console.ixo.earth/credits
|
|
7757
|
+
fundingUrl: https://console.ixo.earth/billing/credits
|
|
7758
7758
|
price:
|
|
7759
7759
|
amountMicroUsd: 1200000
|
|
7760
7760
|
amountCents: 120
|
|
7761
7761
|
currency: USD
|
|
7762
7762
|
amount: "1200000"
|
|
7763
7763
|
asset: upay
|
|
7764
|
-
fundingUrl: https://console.ixo.earth/credits
|
|
7764
|
+
fundingUrl: https://console.ixo.earth/billing/credits
|
|
7765
7765
|
docsUrl: https://console.ixo.earth/docs/errors#PAYMENT_REQUIRED
|
|
7766
7766
|
SPEND_CAP:
|
|
7767
7767
|
value:
|
|
@@ -7777,7 +7777,7 @@ components:
|
|
|
7777
7777
|
currency: USD
|
|
7778
7778
|
amount: "1200000"
|
|
7779
7779
|
asset: upay
|
|
7780
|
-
fundingUrl: https://console.ixo.earth/credits
|
|
7780
|
+
fundingUrl: https://console.ixo.earth/billing/credits
|
|
7781
7781
|
docsUrl: https://console.ixo.earth/docs/errors#SPEND_CAP
|
|
7782
7782
|
INSUFFICIENT_CREDITS:
|
|
7783
7783
|
value:
|
|
@@ -7793,7 +7793,7 @@ components:
|
|
|
7793
7793
|
currency: USD
|
|
7794
7794
|
amount: "1200000"
|
|
7795
7795
|
asset: upay
|
|
7796
|
-
fundingUrl: https://console.ixo.earth/credits
|
|
7796
|
+
fundingUrl: https://console.ixo.earth/billing/credits
|
|
7797
7797
|
docsUrl: https://console.ixo.earth/docs/errors#INSUFFICIENT_CREDITS
|
|
7798
7798
|
NotFound:
|
|
7799
7799
|
description: "`NOT_FOUND` — unknown, or another source's (never 403 across sources)."
|
package/package.json
CHANGED