@settlemint/dalp-cli 2.1.7-main.25423542996 → 2.1.7-main.25431247785

package/dist/dalp.js

@@ -54858,7 +54858,10 @@ function dapiError(args) {
     },
     surfaces: args.surfaces ?? ["orpc-v2-rest", "orpc-rpc"],
     transports: args.transports ?? ["orpc-rest", "orpc-rpc"],
-    observability: dapiObservability({ expectedClientError, severity: args.severity }),
+    observability: dapiObservability({
+      expectedClientError,
+      severity: args.severity
+    }),
     owner: args.owner ?? "dapi",
     ...args.authSensitivity ? { authSensitivity: args.authSensitivity } : {},
     ...args.reviewNotes ? { reviewNotes: args.reviewNotes } : {},
@@ -59807,6 +59810,58 @@ var DAPI_ROUTE_ERROR_ENTRIES = [
       retryable: false,
       expectedClientError: true
     })
+  },
+  {
+    code: "TREASURY_IS_CONTRACT_NOT_SUPPORTED",
+    definition: dapiError({
+      id: "DALP-0465",
+      category: "client",
+      status: 400,
+      message: "Treasury is a contract; ERC-20 allowance must be granted by the treasury contract itself. This route only supports externally-owned treasury wallets.",
+      why: "The configured maturity-redemption treasury is a smart contract. ERC-20 `approve` must be called from the contract that owns the funds, which this route cannot do on its behalf.",
+      fix: "Call `approve(spender, amount)` directly from the treasury contract (e.g. via its admin or governance flow), or reconfigure the feature to use an externally-owned treasury wallet.",
+      retryable: false,
+      expectedClientError: true
+    })
+  },
+  {
+    code: "MATURITY_REDEMPTION_FEATURE_STATE_NOT_INDEXED",
+    definition: dapiError({
+      id: "DALP-0466",
+      category: "client",
+      status: 404,
+      message: "Maturity-redemption feature state not yet indexed for this token",
+      why: "The maturity-redemption feature row for this token has not been created or the indexer has not processed the feature initialization yet, so denomination asset and treasury are still unset.",
+      fix: "Verify the token has the maturity-redemption feature attached and wait for the indexer to catch up, then retry.",
+      retryable: true,
+      expectedClientError: true
+    })
+  },
+  {
+    code: "TREASURY_WALLET_MISMATCH",
+    definition: dapiError({
+      id: "DALP-0467",
+      category: "client",
+      status: 403,
+      message: "Caller wallet does not match the configured treasury wallet for the maturity-redemption feature",
+      why: "ERC-20 `approve` must be called from the wallet that owns the funds. The authenticated caller is not the configured treasury wallet, so this route cannot proxy the approval.",
+      fix: "Retry signed in as the configured treasury wallet.",
+      retryable: false,
+      expectedClientError: true
+    })
+  },
+  {
+    code: "MATURITY_REDEMPTION_TREASURY_NOT_YET_CLASSIFIED",
+    definition: dapiError({
+      id: "DALP-0468",
+      category: "dependency",
+      status: 503,
+      message: "Maturity-redemption treasury has not been classified yet by the indexer",
+      why: "The indexer populates `treasury_is_contract` via a single `eth_getCode` on every `MaturityRedemptionFeatureCreated` / `TreasuryUpdated`, but the column is still `null` for this feature — the indexer has not finished the classification step yet (typical during a partial reindex / backfill). Without that flag we cannot decide whether the approve flow is allowed (EOA treasuries) or must be blocked (contract treasuries), so we refuse to proceed rather than risk a misclassified on-chain failure.",
+      fix: "Wait for the indexer to catch up and retry. If the column stays `null` for an extended period, verify the indexer is healthy and that `MaturityRedemptionFeatureCreated` / `TreasuryUpdated` for this feature were ingested.",
+      retryable: true,
+      expectedClientError: false
+    })
   }
 ];
 var DAPI_ROUTE_ERROR_DEFINITIONS = Object.fromEntries(DAPI_ROUTE_ERROR_ENTRIES.map(({ code: code2, definition }) => [code2, definition]));
@@ -60571,21 +60626,23 @@ var ActionTypeSchema = exports_external.enum([
   "UpdateKYCData",
   "MultisigApproval"
 ]);
-var ActionExecutorSchema = exports_external.object({
-  id: exports_external.string().meta({ description: "Unique identifier for the action executor", examples: ["exec-001", "exec-002"] }),
-  executors: exports_external.array(ethereumAddress).meta({
-    description: "List of addresses authorized to execute actions",
-    examples: [["0x71C7656EC7ab88b098defB751B7401B5f6d8976F"]]
-  })
-});
 var KycActionMetadataSchema = exports_external.object({
-  reason: exports_external.string().meta({ description: "Reason for the update request", examples: ["Address change required", "Document expired"] }),
-  requiredFields: exports_external.array(exports_external.string()).meta({ description: "List of fields that need updating", examples: [["address", "phone"], ["passport"]] }),
+  reason: exports_external.string().meta({
+    description: "Reason for the update request",
+    examples: ["Address change required", "Document expired"]
+  }),
+  requiredFields: exports_external.array(exports_external.string()).meta({
+    description: "List of fields that need updating",
+    examples: [["address", "phone"], ["passport"]]
+  }),
   sourceVersionId: exports_external.string().meta({
     description: "ID of the version to clone data from when creating draft",
     examples: ["ver-001", "ver-002"]
   }),
-  requestId: exports_external.string().meta({ description: "ID of the KYC action request", examples: ["req-001", "req-002"] })
+  requestId: exports_external.string().meta({
+    description: "ID of the KYC action request",
+    examples: ["req-001", "req-002"]
+  })
 });
 var MultisigActionMetadataSchema = exports_external.object({
   userOpHash: exports_external.string().meta({
@@ -60596,7 +60653,10 @@ var MultisigActionMetadataSchema = exports_external.object({
     description: "Smart wallet address — needed to build the sign URL",
     examples: ["0x71C7656EC7ab88b098defB751B7401B5f6d8976F"]
   }),
-  threshold: exports_external.string().meta({ description: "Required cumulative weight (bigint as decimal string)", examples: ["2"] }),
+  threshold: exports_external.string().meta({
+    description: "Required cumulative weight (bigint as decimal string)",
+    examples: ["2"]
+  }),
   currentWeight: exports_external.string().meta({
     description: "Current accumulated weight (bigint as decimal string)",
     examples: ["1"]
@@ -60611,7 +60671,10 @@ var MultisigActionMetadataSchema = exports_external.object({
   })
 });
 var ActionSchema = exports_external.object({
-  id: exports_external.string().meta({ description: "Unique identifier for the action", examples: ["action-001", "action-002"] }),
+  id: exports_external.string().meta({
+    description: "Unique identifier for the action",
+    examples: ["action-001", "action-002"]
+  }),
   actionType: ActionTypeSchema.meta({
     description: "Canonical action type used for filtering and execution",
     examples: ["ApproveXvPSettlement", "UpdateKYCData"]
@@ -60624,21 +60687,30 @@ var ActionSchema = exports_external.object({
     description: "Target address for the action (null for off-chain actions)",
     examples: ["0x71C7656EC7ab88b098defB751B7401B5f6d8976F", null]
   }),
+  tokenAddress: ethereumAddress.nullable().meta({
+    description: "Address of the underlying token this action targets, when distinct from `target` (e.g. ClaimYield's `target` is the yield schedule, while the bond is here). Null for off-chain actions.",
+    examples: ["0x71C7656EC7ab88b098defB751B7401B5f6d8976F", null]
+  }),
   activeAt: timestamp().meta({
     description: "Timestamp when the action becomes active",
     examples: ["2024-01-15T10:30:00.000Z"]
   }),
-  status: ActionStatusSchema.meta({ description: "Current status of the action", examples: ["PENDING", "EXECUTED"] }),
-  executedAt: timestamp().nullable().meta({ description: "Timestamp when the action was executed", examples: ["2024-01-16T14:00:00.000Z", null] }),
+  status: ActionStatusSchema.meta({
+    description: "Current status of the action",
+    examples: ["PENDING", "EXECUTED"]
+  }),
+  executedAt: timestamp().nullable().meta({
+    description: "Timestamp when the action was executed",
+    examples: ["2024-01-16T14:00:00.000Z", null]
+  }),
   executedBy: ethereumAddress.nullable().meta({
     description: "Address that executed the action",
     examples: ["0x71C7656EC7ab88b098defB751B7401B5f6d8976F", null]
   }),
-  executor: ActionExecutorSchema.meta({
-    description: "Executor information for the action",
-    examples: [{ id: "exec-001", executors: ["0x71C7656EC7ab88b098defB751B7401B5f6d8976F"] }]
+  expiresAt: timestamp().nullable().meta({
+    description: "Timestamp when the action expires",
+    examples: ["2024-02-15T10:30:00.000Z", null]
   }),
-  expiresAt: timestamp().nullable().meta({ description: "Timestamp when the action expires", examples: ["2024-02-15T10:30:00.000Z", null] }),
   source: ActionSourceSchema.default("on-chain").meta({
     description: "Source of the action (on-chain or off-chain)",
     examples: ["on-chain", "off-chain"]
@@ -60659,7 +60731,10 @@ var ActionsListInputSchema = exports_external.object({
     description: "Filter actions by their target addresses",
     examples: [["0x71C7656EC7ab88b098defB751B7401B5f6d8976F"]]
   }),
-  name: exports_external.string().optional().meta({ description: "Filter actions by their name", examples: ["Transfer Approval", "KYC Update"] }),
+  name: exports_external.string().optional().meta({
+    description: "Filter actions by their name",
+    examples: ["Transfer Approval", "KYC Update"]
+  }),
   actionType: ActionTypeSchema.optional().meta({
     description: "Filter actions by canonical action type",
     examples: ["ClaimYield", "ApproveXvPSettlement"]
@@ -60874,6 +60949,7 @@ var FixedYieldSchedulePeriodSchema = exports_external.object({
   }),
   completed: exports_external.boolean().meta({ description: "Whether this period has been completed", examples: [true, false] })
 });
+var fixedYieldSchedulePeriod = () => FixedYieldSchedulePeriodSchema;
 var FixedYieldScheduleSchema = exports_external.object({
   id: ethereumAddress.meta({
     description: "Yield schedule contract address",
@@ -62967,6 +63043,14 @@ var TokenSchema = exports_external.object({
       description: "The maturity date of the bond",
       examples: ["2025-12-31T23:59:59Z"]
     }),
+    totalRedeemed: bigDecimal().meta({
+      description: "Cumulative bonds redeemed across all holders (scaled by bond decimals)",
+      examples: ["100", "1500.5"]
+    }),
+    totalRedeemedExact: apiBigInt.meta({
+      description: "Cumulative bonds redeemed across all holders (raw on-chain uint256)",
+      examples: ["100000000000000000000"]
+    }),
     denominationAsset: exports_external.object({
       id: ethereumAddress.meta({
         description: "The address of the denomination asset",
@@ -68828,6 +68912,26 @@ var StatsBondStatusOutputSchema = exports_external.object({
   coveredPercentage: bigDecimal().meta({
     description: "Percentage of denomination assets available (0-100)",
     examples: ["20.00"]
+  }),
+  denominationAssetTreasuryAllowance: bigDecimal().meta({
+    description: "Treasury → maturity-redemption-feature ERC20 allowance for the denomination asset. Indexer-backed (eventually consistent — may briefly read 0 between an Approval tx confirming and the indexer ingesting the event).",
+    examples: ["0.00", "100.00"]
+  }),
+  allowanceCoveredPercentage: bigDecimal().meta({
+    description: "Percentage of required redemption volume covered by the treasury's allowance (0-100)",
+    examples: ["0.00", "100.00"]
+  }),
+  treasuryIsContract: exports_external.boolean().nullable().meta({
+    description: "Whether the treasury address is a contract (vault, true) or an EOA (false). `null` when the indexer has not yet classified the treasury.",
+    examples: [false, true, null]
+  }),
+  treasuryAddress: ethereumAddress.nullable().meta({
+    description: "Treasury address for the maturity-redemption feature",
+    examples: ["0x71C7656EC7ab88b098defB751B7401B5f6d8976F", null]
+  }),
+  featureAddress: ethereumAddress.nullable().meta({
+    description: "Maturity-redemption feature contract address",
+    examples: ["0x71C7656EC7ab88b098defB751B7401B5f6d8976F", null]
   })
 });
 var statsBondStatusContract = v1Contract.route({
@@ -75406,6 +75510,12 @@ var TokenTopUpMaturityTreasuryInputSchema = TokenMutationInputSchema.extend({
     examples: ["1000000000000000000"]
   })
 });
+var TokenFeatureApproveAllowanceInputSchema = TokenMutationInputSchema.extend({
+  amount: assetAmount.meta({
+    description: "Allowance to grant the maturity-redemption feature on the denomination asset, in base units. The treasury wallet must sign this transaction.",
+    examples: ["1000000000000000000"]
+  })
+});
 var TokenSetTransactionFeeRatesInputSchema = TokenMutationInputSchema.extend({
   mintFeeBps: basisPoints().meta({
     description: "Mint fee rate in basis points (e.g. 200 = 2%)",
@@ -75950,6 +76060,13 @@ var featureRedeem = v2Contract.route({
   successDescription: "Tokens redeemed via maturity feature successfully.",
   tags: [V2_TAG.token]
 }).meta({ contractErrors: [...COMMON_CONTRACT_ERRORS] }).input(v2Input.paramsBody(TokenReadInputSchema, TokenFeatureRedeemInputSchema.omit({ tokenAddress: true }))).output(mutationOutput);
+var featureApproveAllowance = v2Contract.route({
+  method: "POST",
+  path: "/tokens/{tokenAddress}/maturity-redemption/treasury-allowance",
+  description: "Approve the maturity-redemption feature to spend denomination asset out of the configured treasury. Caller must be the treasury wallet — without this allowance `feature.redeem(...)` reverts with ERC20InsufficientAllowance because the feature uses `transferFrom` to pay holders.",
+  successDescription: "Treasury allowance approved successfully.",
+  tags: [V2_TAG.token]
+}).meta({ contractErrors: [...COMMON_CONTRACT_ERRORS] }).input(v2Input.paramsBody(TokenReadInputSchema, TokenFeatureApproveAllowanceInputSchema.omit({ tokenAddress: true }))).output(mutationOutput);
 var setTransactionFeeRates = v2Contract.route({
   method: "PATCH",
   path: "/tokens/{tokenAddress}/transaction-fee/rates",
@@ -76153,6 +76270,7 @@ var tokenV2MutationsContract = {
   setYieldTreasury,
   featureMature,
   featureRedeem,
+  featureApproveAllowance,
   matureEarly,
   setMaturityTreasury,
   topUpMaturityTreasury,
@@ -76288,9 +76406,29 @@ var TokenFeatureFixedTreasuryYieldSchema = exports_external.object({
     description: "Treasury funding the yield payouts",
     examples: ["0x71C7656EC7ab88b098defB751B7401B5f6d8976F"]
   }),
+  totalYield: bigDecimal().meta({
+    description: "Total yield generated across completed periods (denomination asset units)",
+    examples: ["7500.00"]
+  }),
   totalClaimed: bigDecimal().meta({
     description: "Total yield claimed (denomination asset units)",
     examples: ["5000.00"]
+  }),
+  totalUnclaimedYield: bigDecimal().meta({
+    description: "Total unclaimed yield = totalYield - totalClaimed (denomination asset units)",
+    examples: ["2500.00"]
+  }),
+  currentPeriod: fixedYieldSchedulePeriod().nullable().meta({
+    description: "Active period when chain time is within [startDate, endDate); null when not yet started or fully ended",
+    examples: [null]
+  }),
+  nextPeriod: fixedYieldSchedulePeriod().nullable().meta({
+    description: "Period scheduled to start after the current one; null on the final period",
+    examples: [null]
+  }),
+  periods: exports_external.array(fixedYieldSchedulePeriod()).meta({
+    description: "All scheduled periods. Per-period totalYield/totalUnclaimed populate as each period closes; configured rows exist from creation",
+    examples: [[]]
   })
 }).nullable();
 var TokenFeatureVotingPowerSchema = exports_external.object({
@@ -77394,9 +77532,9 @@ var TokenAssetV2Schema = exports_external.object({
   }).nullable().meta({ description: "The yield details", examples: [] })
 });
 var UserAssetBalanceV2ItemSchema = exports_external.object({
-  id: ethereumHex.meta({
-    description: "The balance record ID",
-    examples: ["0x1234567890abcdef"]
+  id: exports_external.uuid().meta({
+    description: "The balance record ID (idxr_token_balances.id, UUIDv7).",
+    examples: ["019283bc-7e0a-7c3d-9b1f-3f4d2c5e6a7b"]
   }),
   value: bigDecimal().meta({
     description: "The total balance amount",
@@ -78012,7 +78150,7 @@ function normalizeDalpBaseUrl(url3) {
 }
 var package_default = {
   name: "@settlemint/dalp-sdk",
-  version: "2.1.7-main.25423542996",
+  version: "2.1.7-main.25431247785",
   private: false,
   description: "Fully typed SDK for the DALP tokenization platform API",
   homepage: "https://settlemint.com",
@@ -78563,7 +78701,7 @@ function trimConfigValue(name, value3) {
 // package.json
 var package_default2 = {
   name: "@settlemint/dalp-cli",
-  version: "2.1.7-main.25423542996",
+  version: "2.1.7-main.25431247785",
   private: false,
   description: "CLI for the Digital Asset Lifecycle Platform — manage tokens, identities, compliance, and more from the command line.",
   homepage: "https://settlemint.com",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@settlemint/dalp-cli",
-  "version": "2.1.7-main.25423542996",
+  "version": "2.1.7-main.25431247785",
   "private": false,
   "description": "CLI for the Digital Asset Lifecycle Platform — manage tokens, identities, compliance, and more from the command line.",
   "homepage": "https://settlemint.com",