@v3finance/core-sdk 0.2.0 → 0.2.2

package/src/generated/operations.ts

@@ -9,7 +9,7 @@
 // the API does not slip in unclassified.
 //
 // Operations: 171 · admin: 40 · both: 1 · member: 127 · service: 3
-// Spec sha256: a03bd2e06186734bd8816c3d764dd90a48c1c31d7edda2743a3ae29550601cd1
+// Spec sha256: 30be5f9b9733d1d1d67eebf21e0bfaa457651e951676211ec9fa464cca5d3795
 
 export type Audience = 'member' | 'admin' | 'service' | 'both' | 'unknown'
 

package/src/generated/types.ts

@@ -250,8 +250,8 @@ export interface AddressDetail {
   tokenId: string | null
   /** format: date-time */
   createdAt: string
-  /** Сводка совместного доступа. Приходит в списке и детали адреса; PATCH /addresses/{id} переиспользует эту же схему и sharing НЕ возвращает */
-  sharing?: SharingSummary
+  /** Сводка совместного доступа. Приходит всегда: в списке, ответе PATCH и детали адреса */
+  sharing: SharingSummary
   /** Код токена адреса (из segmentsJson + asset route) */
   asset: string | null
   assetName: string | null
@@ -322,6 +322,7 @@ export interface OutgoingTxSummary {
   status: string
   txHash: string | null
   fee: string | null
+  /** Причина закрытия — только у failed/rejected/cancelled. У остальных статусов (awaiting_approval, pending, submitted, confirmed) — ВСЕГДА null: у незакрытого перевода причины отказа нет. Неясный исход исполнения (pending, транзакция могла уйти в сеть) здесь не показывается — его признак pending дольше 10 минут по updatedAt («ждёт сверки администратором») */
   failureReason: string | null
   /** format: date-time */
   createdAt: string
@@ -491,8 +492,8 @@ export interface AddressListItem {
   assetSymbol: string | null
   /** Баланс в decimal (по token.decimals). NULL — ledger-счёта ещё нет */
   balanceDecimal: string | null
-  /** Сводка совместного доступа. Приходит в списке и детали адреса; PATCH /addresses/{id} переиспользует эту же схему и sharing НЕ возвращает */
-  sharing?: SharingSummary
+  /** Сводка совместного доступа. Приходит всегда: в списке, ответе PATCH и детали адреса */
+  sharing: SharingSummary
   /** Владелец адреса (создатель) с UI-метаданными */
   owner: MemberCard | null
   access: AddressAccess
@@ -791,11 +792,11 @@ export interface ApprovalRequestDetail {
 
 export interface ApprovalRequestEvent {
   id: string
-  /** created|voted|approved|rejected|cancelled|applied|apply_failed|stale */
+  /** created|voted|approved|rejected|cancelled|applied|apply_failed|stale|folder_skipped. folder_skipped идёт ПОСЛЕ applied: адрес по заявке create_address создан, но в папку, выбранную при подаче, не положен (папку удалили или у инициатора отозвали право) — причина в comment */
   type: string
   actorId: string | null
   decision: string | null
-  /** Пояснение ПОДПИСАНТА. У события applied всегда null — id созданного объекта лежит в resultId, чтобы клиент не напечатал его как комментарий */
+  /** У voted — пояснение ПОДПИСАНТА; у stale, apply_failed и folder_skipped — системное пояснение для человека. У события applied всегда null — id созданного объекта лежит в resultId, чтобы клиент не напечатал его как комментарий */
   comment: string | null
   /** Только у applied: id созданного/изменённого объекта */
   resultId: string | null
@@ -1328,7 +1329,7 @@ export interface CreateAddressBody {
    * length: 1..16
    */
   emoji?: string
-  /** Создать адрес В группу адресов (нужно право create_address на группе). Новый адрес — member группы, доступен её участникам */
+  /** Создать адрес В группу адресов (нужно право create_address на группе). Новый адрес — member группы, доступен её участникам. Если создание ушло на подпись (202), папка сохраняется в заявке, а право на неё перепроверяется при применении: отозвали — адрес создаётся без папки, с оговоркой applyWarnings в ответе голосования. При прямом создании (201) то же — оговорка `warnings` в теле ответа */
   groupId?: string
 }
 
@@ -1354,6 +1355,15 @@ export interface CreateAddressResult {
     label: string | null
     description: string | null
   }
+  /** Создано, но не всё: адрес есть, а в папку из `groupId` не положен. Право на папку роут проверяет до создания (иначе 403), а запись членства — уже после Wallet Service и мониторинга; право могли отозвать в этом окне или запись могла не пройти. Есть только когда непусто; не показывать адрес в папке, если оговорка пришла */
+  warnings?: FolderSkipWarning[]
+}
+
+export interface FolderSkipWarning {
+  /** FOLDER_NOT_FOUND — папку удалили; FOLDER_FORBIDDEN — у создателя адреса больше нет права заводить в неё адреса; FOLDER_WRITE_FAILED — сбой записи */
+  code: "FOLDER_NOT_FOUND" | "FOLDER_FORBIDDEN" | "FOLDER_WRITE_FAILED"
+  /** Готовая фраза для человека */
+  message: string
 }
 
 export interface CreateCompositeBody {
@@ -1717,7 +1727,7 @@ export interface CreateTransactionResult {
     amountDecimal: string
     asset: string
     network: string
-    /** confirmed — новый успешный перевод; pending/failed возможны при replay по idempotencyKey */
+    /** 201 — confirmed (исполнен сейчас); редко pending с заполненным txHash (транзакция ушла в сеть, а учёт не записался — доводит сверка, повторять перевод нельзя); 202 — awaiting_approval; 200 (replay по idempotencyKey) — ТЕКУЩИЙ статус перевода, любой: pending (первый запрос ещё исполняется — или его исход неизвестен: первый ответ был 502 TRANSFER_OUTCOME_UNKNOWN; повтор НЕ исполняет перевод заново, исход устанавливает сверка), awaiting_approval, confirmed, failed, rejected, cancelled */
     status: string
     txHash: string | null
     fee: string | null
@@ -1732,12 +1742,13 @@ export interface CreateTransactionResult {
 
 export interface CreateTransferBody {
   fromAddressId: string
+  /** Адрес получателя. Формат проверяется по типу сети адреса-отправителя ДО резерва средств: TRON — base58check (34 символа, «T…», контрольная сумма), EVM — 0x + 40 hex (смешанный регистр — контрольная сумма EIP-55). Не подошёл — 400 INVALID_DESTINATION_ADDRESS. Строка проверяется как есть, пробелы по краям — ошибка формата */
   toAddress: string
   /** DECIMAL строка — конвертируется по token.decimals */
   amount: string
   asset: string
   /**
-   * Уникальный ключ попытки перевода (рекомендуется: uuid). Повторный запрос с тем же ключом вернёт существующую транзакцию без второго broadcast. Для новой попытки после failed — новый ключ.
+   * Уникальный ключ попытки перевода (рекомендуется: uuid). Повторный запрос с тем же ключом и теми же параметрами вернёт 200 с существующим переводом — без второго broadcast, без повторной оценки политик. Тот же ключ с другими параметрами — 409 IDEMPOTENCY_KEY_REUSED. Для новой попытки после failed — новый ключ.
    *
    * length: 8..128
    */
@@ -2024,6 +2035,7 @@ export interface HistoryOutItem {
   asset: string
   assetSymbol: string
   fee: string | null
+  /** Причина закрытия — только у failed/rejected/cancelled. У остальных статусов (awaiting_approval, pending, submitted, confirmed) — ВСЕГДА null: у незакрытого перевода причины отказа нет. Неясный исход исполнения (pending, транзакция могла уйти в сеть) здесь не показывается — его признак pending дольше 10 минут по updatedAt («ждёт сверки администратором») */
   failureReason: string | null
   fromAddress: {
     id: string
@@ -3164,7 +3176,7 @@ export interface RatesResponse {
 }
 
 export interface ReconcileTransferBody {
-  /** Хеш от подписывающего сервиса. ЕСТЬ — транзакция ушла в сеть, перевод доводится до confirmed. НЕТ (или null) — считаем, что broadcast'а не было, и возвращаем резерв (failed) */
+  /** Хеш от подписывающего сервиса. ЕСТЬ — транзакция ушла в сеть, перевод доводится до confirmed. НЕТ (или null) — сверяющий утверждает, что broadcast'а не было, и резерв возвращается (failed). Для pending с неясным исходом (у pending без txHash его не отличить по ответам API — failureReason у незакрытого перевода null) это утверждение нужно ПРОВЕРИТЬ по сети: возврат за ушедшую транзакцию печатает деньги. Если у pending-перевода хеш уже сохранён (broadcast прошёл), он обязателен: без него — 409 TRANSFER_BROADCAST, с другим — 409 TXHASH_MISMATCH (сохранённый — в error.details.txHash) */
   txHash?: string | null
   /** Комиссия, если известна */
   fee?: string | null
@@ -3173,7 +3185,8 @@ export interface ReconcileTransferBody {
 }
 
 export interface ReconcileTransferResult {
-  status: "confirmed" | "failed"
+  /** Статус перевода после сверки: confirmed (по хешу) | failed (резерв возвращён). rejected/cancelled — у закрытого перевода с невозвращённым резервом: резерв возвращён, статус прежний */
+  status: "confirmed" | "failed" | "rejected" | "cancelled"
   txHash: string | null
 }
 
@@ -3194,8 +3207,9 @@ export interface RequestVoteResult {
   approvals: number
   /** range: -9007199254740991..9007199254740991 */
   threshold: number
-  /** true — этот голос финализировал заявку (применена/отклонена) */
+  /** true — этот голос финализировал заявку (применена/отклонена). У заявки на перевод status=APPROVED при finalized=false значит, что исход рассчитал НЕ этот вызов: applyError пуст — перевод исполняет (исполнил) параллельный запрос ЛИБО исполнение, начатое другим вызовом, оборвалось (сам перевод тогда не закроется); исход — только по GET /transfers/{id}: confirmed/failed, а pending дольше 10 минут по updatedAt — ждёт сверки (admin). applyError TRANSFER_EXECUTION_FAILED — к моменту одобрения перевод уже не ждал подписей. finalized=false с пустым applyError приходит и тогда, когда одобрил ЭТОТ голос, но исход перевода им не установлен (перевод pending: подписывающий сервис не дал определённого ответа, транзакция могла уйти в сеть, а могла и нет): показывайте «голос учтён», не «применено». finalized=true с пустым applyError у перевода — исполнен этим вызовом (confirmed) */
   finalized: boolean
+  /** Голос финализировал заявку, а применение не дало результата; status при этом итоговый. Коды: STALE — цель изменилась (status=REJECTED); APPLY_FAILED / APPLY_FAILED_ROLLED_BACK / APPLY_FAILED_PARTIAL — мутация не применена (целиком / цепочка откатана / частично). У action=transfer финальный approve ИСПОЛНЯЕТ перевод, status=APPROVED: TRANSFER_EXECUTION_FAILED — перевод не исполнен (обычно failed, резерв возвращён; точный статус — GET /transfers/{id}; при finalized=false — перевод уже не ждал подписей, одобрение его не исполняло). Неясный исход перевода (подписывающий сервис не дал определённого ответа, перевод pending, средства зарезервированы, транзакция могла уйти в сеть, исход установит сверка, admin) ошибкой НЕ отдаётся: applyError null, status APPROVED, finalized=false. Кода TRANSFER_OUTCOME_UNKNOWN здесь нет — он только у POST /transfers */
   applyError: {
     code: string
     message: string
@@ -3203,6 +3217,8 @@ export interface RequestVoteResult {
   resolvedResultId: string | null
   /** Только для композитных заявок: прогресс по шагам */
   stepsProgress?: StepProgress[]
+  /** Применено, но не всё: адрес по заявке create_address создан (resolvedResultId), а в папку, выбранную при подаче, не положен. Право на папку проверяется при ПРИМЕНЕНИИ, а не при подаче. Есть только когда непусто; в истории заявки — событие folder_skipped */
+  applyWarnings?: FolderSkipWarning[]
 }
 
 export interface StepProgress {
@@ -3365,6 +3381,7 @@ export interface TransactionDetail {
   decisionPolicyCode: string | null
   /** Человеческое название решающей политики (для UI вместо кода) */
   decisionPolicyName: string | null
+  /** Причина закрытия — только у failed/rejected/cancelled. У остальных статусов (awaiting_approval, pending, submitted, confirmed) — ВСЕГДА null: у незакрытого перевода причины отказа нет. Неясный исход исполнения (pending, транзакция могла уйти в сеть) здесь не показывается — его признак pending дольше 10 минут по updatedAt («ждёт сверки администратором») */
   failureReason: string | null
   /** format: date-time */
   createdAt: string
@@ -3698,7 +3715,7 @@ export interface VoteRequestBody {
 }
 
 export interface VoteResult {
-  /** Статус перевода ПОСЛЕ голоса: awaiting_approval (голосов мало) | rejected | confirmed/failed (финальный approve исполняет сразу) */
+  /** Статус перевода ПОСЛЕ голоса: awaiting_approval (голосов мало) | rejected | confirmed/failed (финальный approve исполняет сразу). pending — исполнение не закончено, повторять перевод нельзя; executionError у pending всегда null, исход этим ответом НЕ установлен, ждать его «через секунды» нельзя. Так отдаётся и неясный исход (подписывающий сервис не дал определённого ответа, транзакция могла уйти в сеть, резерв стоит — доводит сверка, admin), и: txHash в GET /transfers/{id} есть — транзакция ушла в сеть, а учёт не записался, доводит сверка (admin) по этому хешу; перевод исполняет параллельный запрос (одновременный голос другого подписанта или исходный вызов при повторе голоса) ЛИБО исполнение оборвалось (клиент, который его начал, отключился — сам перевод тогда не закроется). Различает только время: перечитывайте GET; confirmed/failed — исход; pending дольше 10 минут по updatedAt — «ждёт сверки администратором» */
   status: string
   /**
    * Собрано approve-голосов
@@ -3708,7 +3725,7 @@ export interface VoteResult {
   approvals: number
   /** range: -9007199254740991..9007199254740991 */
   threshold: number
-  /** Если финальный approve запустил исполнение и оно упало (средства возвращены) */
+  /** Финальный approve запустил исполнение, и оно перевод НЕ исполнило. code: TRANSFER_EXECUTION_FAILED — не исполнен (status=failed, средства возвращены; исключения: failed с txHash у перевода, см. описание ручки, и status=pending, если сам возврат резерва не записался — тогда перевод доводит сверка). Тот же код — если к моменту одобрения перевод уже не ждал подписей (status — его фактический: failed/rejected/cancelled): одобрение его не исполнило. Неясный исход (подписывающий сервис не дал определённого ответа, транзакция могла уйти в сеть) ошибкой НЕ отдаётся: status=pending, executionError=null — показывайте «исполняется, исход уточняется». Кода TRANSFER_OUTCOME_UNKNOWN в голосе нет, он только у POST /transfers */
   executionError: {
     code: string
     message: string

package/src/resources/addresses.ts

@@ -73,9 +73,10 @@ export class AddressesResource {
   /**
    * Metadata only: this touches neither money nor the derivation path.
    *
-   * Answers with the listing shape, minus `sharing` — the endpoint reuses the
-   * schema but does not fill that property, which is why it is optional on
-   * `Address`. Refresh the list rather than reading the share count back.
+   * Answers with the same row as the listing — `owner`, `access` and
+   * `sharing` included — so it can replace the address in a list without a
+   * refetch. Recent operations and `shares`, which `get()` carries, are not
+   * in it.
    */
   update(addressId: string, input: PatchAddressBody): Promise<Address> {
     return this.#http.request<Address>('PATCH', `${this.#base}/${seg(addressId)}`, { body: input })

package/src/resources/approvals.ts

@@ -79,6 +79,28 @@ export class ApprovalsResource {
    *
    * Read `finalized` with `applyError`: a vote can finalize a request AND
    * fail to apply it, and then the money has not moved.
+   *
+   * On a transfer request the approve that completes the threshold EXECUTES
+   * the transfer inside this call, and `status` is `APPROVED` whatever
+   * happened to the transfer:
+   *
+   *   finalized, no applyError     — executed by this call;
+   *   applyError                   — `TRANSFER_EXECUTION_FAILED`, not executed
+   *                                  (usually `failed`, reserve returned);
+   *   not finalized, no applyError — the outcome is NOT established by this
+   *                                  answer: the signing service gave no
+   *                                  definite answer (the transaction may
+   *                                  have left; an administrator's
+   *                                  reconciliation settles it), another call
+   *                                  is executing the transfer, or the
+   *                                  execution broke off. Read the outcome
+   *                                  from the transfer (`transfers.get`), and
+   *                                  never resubmit it.
+   *
+   * Repeating the same decision on a request that is still open finishes what
+   * an earlier call left undone (it recorded the vote and broke off) — a veto,
+   * or an approval once the threshold is met — instead of 409
+   * `ALREADY_VOTED`.
    */
   vote(requestId: string, input: VoteBody): Promise<RequestVoteResult> {
     return this.#http.request<RequestVoteResult>(

package/src/resources/transfers.ts

@@ -21,12 +21,28 @@ export interface VoteInput {
  * The result of sending is `Gated`, and that is the main thing to understand
  * here. The same `{transaction}` body comes back in three situations:
  *
- *   applied (201)  — executed, the money left;
+ *   applied (201)  — executed, the money left (rarely the status is still
+ *                    `pending` with a `txHash`: it went out, but its
+ *                    accounting was not recorded, and an administrator's
+ *                    reconciliation finishes it — do not send it again);
  *   pending (202)  — awaiting signatures, funds RESERVED but not sent;
- *   replayed (200) — a repeat; the transfer already existed.
+ *   replayed (200) — a transfer with this `idempotencyKey` already existed,
+ *                    and this is that transfer as it stands NOW.
  *
  * They cannot be told apart by the body. Showing "sent" on `pending` tells
  * the person money has gone when it is frozen.
+ *
+ * `replayed` does not mean "sent" either. It says only that the request was
+ * seen before; what became of it is in `data.transaction.status`:
+ *
+ *   confirmed, submitted     — it left;
+ *   awaiting_approval        — waiting for signatures, funds reserved;
+ *   pending                  — still executing, or its outcome is unknown
+ *                              (the first answer was 502
+ *                              `TRANSFER_OUTCOME_UNKNOWN`) until an
+ *                              administrator reconciles it;
+ *   failed, rejected,
+ *   cancelled                — it did not leave.
  */
 export class TransfersResource {
   readonly #http: HttpClient
@@ -37,7 +53,19 @@ export class TransfersResource {
     this.#base = `/api/v1/vaults/${seg(vaultCode)}/transfers`
   }
 
-  /** Sends a transfer. The timeout is long: the path calls the wallet service. */
+  /**
+   * Sends a transfer. The timeout is long: the path calls the wallet service.
+   *
+   * On `outcome: 'replayed'` read `data.transaction.status` before telling
+   * anyone anything — a replay of an attempt that failed, or that is still
+   * waiting for signatures, comes back the same way as one that went out.
+   *
+   * A thrown 502 `TRANSFER_OUTCOME_UNKNOWN` is not a failure: the signing
+   * service gave no definite answer, the transaction may have left, and the
+   * transfer stays `pending` with its funds reserved (`details.transactionId`).
+   * Retry it only with the SAME key — that returns the transfer without
+   * executing it again; a new key can send the money twice.
+   */
   async send(
     input: CreateTransferBody,
     options: { signal?: AbortSignal; timeoutMs?: number } = {},
@@ -56,7 +84,9 @@ export class TransfersResource {
   /**
    * One transfer in full. Note the shape: this is the transaction itself, not
    * the `{ transaction }` wrapper that `send()` returns — and it carries more,
-   * including `amlLevel`, `approvers`, `usdRate` and `failureReason`.
+   * including `amlLevel`, `approvers`, `usdRate` and `failureReason` — the
+   * last only on `failed`, `rejected` and `cancelled`, `null` on any other
+   * status.
    */
   get(transferId: string): Promise<TransactionDetail> {
     return this.#http.request<TransactionDetail>('GET', `${this.#base}/${seg(transferId)}`)
@@ -75,11 +105,30 @@ export class TransfersResource {
    *   awaiting_approval — counted, more signatures still needed;
    *   rejected          — a `reject` is a veto, and the reserve is released;
    *   confirmed/failed  — this vote completed the threshold, so execution ran
-   *                       INSIDE this request (gas, then broadcast, ~10s).
+   *                       INSIDE this request (gas, then broadcast, ~10s);
+   *   pending           — with no `executionError`: the outcome is NOT
+   *                       established by this answer. The signing service
+   *                       gave no definite answer (the transaction may have
+   *                       left; an administrator's reconciliation settles
+   *                       it), another call is executing the transfer, or
+   *                       the execution broke off. Re-read the transfer:
+   *                       `confirmed`/`failed` is the outcome, `pending` for
+   *                       over 10 minutes by `updatedAt` is waiting for
+   *                       reconciliation. Never send it again.
    *
    * `failed` means the money is back: execution broke after approval and the
    * reserve was released, with the reason in `executionError`. Treating the
-   * call as "approved, done" hides both the success and that failure.
+   * call as "approved, done" hides both the success and that failure. The
+   * exception is a `failed` transfer that has a `txHash`: it went out after
+   * reconciliation had already returned the reserve, and an administrator has
+   * to correct the ledger. `executionError` beside `rejected` or `cancelled`
+   * means the transfer was no longer waiting for signatures when approved,
+   * and nothing was executed.
+   *
+   * Repeating the same decision while the transfer is still waiting finishes
+   * what an earlier call left undone (it recorded the vote and broke off) — a
+   * veto, or execution once the threshold is met — instead of 409
+   * `ALREADY_VOTED`.
    */
   vote(transferId: string, input: VoteInput): Promise<VoteResult> {
     return this.#http.request<VoteResult>(
@@ -108,19 +157,34 @@ export class TransfersResource {
   }
 
   /**
-   * Settles a transfer stuck in `pending` — the case where the worker died
-   * mid-execution, so cancelling does not apply. Administrators only.
+   * Settles a transfer nothing else can close. Administrators only.
+   *
+   *   pending            — execution died, or its outcome is unknown (the
+   *                        send answered 502 `TRANSFER_OUTCOME_UNKNOWN`);
+   *   awaiting_approval  — with no live approval request to vote on;
+   *   failed, rejected,
+   *   cancelled          — closed, but the reserve is still held: it is
+   *                        returned, and the status stays.
+   *
+   * A pending transfer is decided by the HASH: send `txHash` and it is driven
+   * to `confirmed`; send none and the reserve is returned (`failed`). Sending
+   * none is YOUR statement that nothing was broadcast — the server does not
+   * check it, so look on the chain first: returning the reserve of a
+   * transaction that did go out creates money. If the transfer already holds
+   * a hash from the signing service, only that hash, sent explicitly, settles
+   * it — 409 `TRANSFER_BROADCAST` without one, `TXHASH_MISMATCH` with another,
+   * the saved hash in `details.txHash`. The other two cases never executed
+   * and take no hash.
    *
-   * The decision is made by the HASH: send `txHash` and the transfer is
-   * driven to `confirmed`, because the signing service did put it on the
-   * chain; send none and the reserve is returned, because there was no
-   * broadcast. A FRESH pending transfer is refused on purpose — while
-   * execution may still be in flight, intervening risks a SECOND broadcast,
-   * which costs more than waiting.
+   * A FRESH transfer is refused on purpose — while execution may still be in
+   * flight, intervening risks a SECOND broadcast, which costs more than
+   * waiting.
    *
-   * Pass `fee` along with the hash if you know it: this is the only moment
-   * it can be recorded on a transfer settled this way, and it stays null
-   * otherwise. The answer says which way it went — `confirmed` or `failed`.
+   * Pass `fee` along with the hash if you know it: this is the only moment it
+   * can be recorded on a transfer settled this way; otherwise it stays as it
+   * is, null unless the signing service reported one. The answer says which
+   * way it went — `confirmed`, `failed`, or the unchanged `rejected` /
+   * `cancelled` of a closed transfer.
    */
   reconcile(
     transferId: string,

package/src/resources/types.ts

@@ -42,10 +42,6 @@ import type {
  * the two must not be merged, because "no account" and "empty account"
  * deserve different wording. Amounts are raw smallest units; put them through
  * the helpers in `units.ts` rather than `Number`.
- *
- * One field is thinner than the type admits: `sharing` is optional because
- * `PATCH /addresses/{id}` reuses this schema WITHOUT it (the document says so
- * itself, on the property). Listings and the detail endpoint do send it.
  */
 export type Address = AddressListItem
 

package/src/version.ts

@@ -1,5 +1,5 @@
 /** SDK version, sent in the `user-agent` header. */
-export const SDK_VERSION = '0.2.0'
+export const SDK_VERSION = '0.2.2'
 
 /** Default API base URL. */
 export const DEFAULT_BASE_URL = 'https://policy-engine-rest.ezig.workers.dev'