@settlemint/dalp-cli 3.0.7-main.28619722466 → 3.0.7-main.28622819856

package/dist/dalp.js

@@ -133895,6 +133895,92 @@ var AssumableParticipantsV2ListInputSchema = AssumableParticipantsCollectionInpu
   }
 });
 var AssumableParticipantsV2ListOutputSchema = createPaginatedResponse(AssumableParticipantSchema);
+var HoldingWalletTypeSchema = exports_external.enum(["eoa", "smart"]).meta({
+  description: "Account type holding this balance: `smart` (smart account) or `eoa` (key account)."
+});
+var HoldingTransferVerdictSchema = exports_external.enum(["transferable", "restricted"]).meta({
+  description: "Transfer verdict evaluated against the holding participant's identity, independent of the viewer. `restricted` gates the Transfer action."
+});
+var HoldingAssetClassSchema = exports_external.object({
+  id: exports_external.string().meta({ description: "Asset class definition id.", examples: ["cls_equity"] }),
+  slug: exports_external.string().meta({ description: "Asset class slug used for grouping.", examples: ["equity", "cash"] }),
+  name: exports_external.string().meta({ description: "Human-readable asset class name.", examples: ["Equity", "Cash"] })
+}).meta({ description: "Asset class the token belongs to." });
+var HoldingTokenSchema = exports_external.object({
+  id: ethereumAddress.meta({
+    description: "The token contract address.",
+    examples: ["0x71C7656EC7ab88b098defB751B7401B5f6d8976F"]
+  }),
+  name: exports_external.string().meta({ description: "The token name.", examples: ["Acme Series A"] }),
+  symbol: assetSymbol().meta({ description: "The token symbol.", examples: ["ACME", "USDC"] }),
+  type: assetType().or(exports_external.string().min(1)).meta({
+    description: "Asset type — known system types or custom template slugs. Drives the asset detail route.",
+    examples: ["equity", "bond", "custom-deposit"]
+  }),
+  isExternal: exports_external.boolean().meta({
+    description: "True when the token is registered through the ExternalTokenRegistry rather than deployed by a system factory.",
+    examples: [false, true]
+  }),
+  decimals: decimals().meta({ description: "The number of decimal places.", examples: [18, 6] })
+});
+var ParticipantHoldingV2ItemSchema = exports_external.object({
+  id: exports_external.string().meta({
+    description: "Stable row identifier — the token address and wallet address joined.",
+    examples: ["0x71c7…976f:0x8ba1…ba72"]
+  }),
+  token: HoldingTokenSchema.meta({ description: "The token details.", examples: [] }),
+  assetClass: HoldingAssetClassSchema.nullable().meta({
+    description: "The token's asset class. Null for external tokens (no template) — rendered under External tokens.",
+    examples: [null]
+  }),
+  walletAddress: ethereumAddress.meta({
+    description: "The participant wallet address that holds this balance.",
+    examples: ["0x71C7656EC7ab88b098defB751B7401B5f6d8976F"]
+  }),
+  walletType: HoldingWalletTypeSchema,
+  balance: bigDecimal().meta({ description: "The total balance amount (scaled by decimals).", examples: ["250"] }),
+  frozen: bigDecimal().meta({ description: "The frozen balance amount.", examples: ["0", "50"] }),
+  available: bigDecimal().meta({
+    description: "The available balance amount (total minus frozen; zero when the whole address is frozen).",
+    examples: ["250", "200"]
+  }),
+  valueInBaseCurrency: bigDecimal().nullable().meta({
+    description: "Available balance multiplied by the token's resolved base-currency price. Null when no FX/price path is available.",
+    examples: ["5.00", null]
+  }),
+  priceInBaseCurrencyReliable: exports_external.boolean().meta({
+    description: "Whether the FX chain used to populate the base-currency price was fully reliable. False when no price is available or a hop fell back to a stale rate.",
+    examples: [true, false]
+  }),
+  transferVerdict: HoldingTransferVerdictSchema,
+  restrictionReason: exports_external.string().nullable().meta({
+    description: "Reason a row is restricted (e.g. `frozen`, `identity pending`). Null for transferable rows; the UI renders a generic reason when a restricted row carries no specific reason.",
+    examples: ["frozen", "identity pending", null]
+  })
+});
+var ParticipantHoldingsParamsSchema = exports_external.object({
+  participantId: exports_external.string().min(1).meta({
+    description: "Identifier of the participant whose holdings are being listed."
+  })
+});
+var PARTICIPANT_HOLDINGS_COLLECTION_FIELDS = {
+  tokenAddress: addressField(),
+  tokenName: textField(),
+  tokenSymbol: textField(),
+  walletAddress: addressField(),
+  walletType: enumField(["eoa", "smart"], { sortable: false }),
+  balance: bigintField({ filterable: false })
+};
+var ParticipantHoldingsV2ListInputSchema = createCollectionInputSchema(PARTICIPANT_HOLDINGS_COLLECTION_FIELDS, {
+  defaultSort: "-balance",
+  globalSearch: true
+});
+var ParticipantHoldingsV2ListOutputSchema = createPaginatedResponse(ParticipantHoldingV2ItemSchema, {
+  balancesAsOf: timestamp().nullable().meta({
+    description: "The most recent indexed `updatedAt` across the returned holdings — the freshness stamp shown on the tab. Null when the participant holds nothing.",
+    examples: ["2026-06-24T14:32:00.000Z", null]
+  })
+});
 var ParticipantAddressPurposeSchema = exports_external.enum(["transfer", "identity", "participant"]);
 var ParticipantKindSchema = exports_external.enum([
   "person",
@@ -133989,6 +134075,13 @@ var activityStats = v2Contract.route({
   successDescription: "Activity statistics retrieved successfully.",
   tags: [V2_TAG.participants]
 }).input(v2Input.paramsQuery(ParticipantActivityParamsSchema, ActivityStatsInputSchema.omit({ accountAddress: true }))).output(createSingleResponse(ActivityStatsOutputSchema));
+var holdings = v2Contract.route({
+  method: "GET",
+  path: "/participants/{participantId}/holdings",
+  description: "List a participant's real indexed holdings (one row per token × wallet) with asset class, available/frozen balances, base-currency value, a per-row transfer verdict, and a `balancesAsOf` freshness stamp. Powers the participant detail Holdings tab.",
+  successDescription: "Paginated array of participant holdings with asset class, balances, value, and transfer verdict; `meta.balancesAsOf` carries the freshness stamp.",
+  tags: [V2_TAG.participants]
+}).input(v2Input.paramsQuery(ParticipantHoldingsParamsSchema, ParticipantHoldingsV2ListInputSchema)).output(ParticipantHoldingsV2ListOutputSchema);
 var assumableList = v2Contract.route({
   method: "GET",
   path: "/participants/assumable",
@@ -134001,6 +134094,7 @@ var participantsV2Contract = {
   assumableList,
   addressKinds,
   smartWalletRead,
+  holdings,
   activityList,
   activityStats,
   complianceEligibility: complianceEligibilityV2Contract
@@ -140561,7 +140655,7 @@ var events2 = v2Contract.route({
     examples: ["0x71C7656EC7ab88b098defB751B7401B5f6d8976F"]
   })
 }), TokenEventsV2InputSchema)).output(TokenEventsV2OutputSchema);
-var holdings = v2Contract.route({
+var holdings2 = v2Contract.route({
   method: "GET",
   path: "/tokens/{tokenAddress}/holdings",
   description: "List every asset the specified token holds a balance in (its treasury). Supports JSON:API pagination, sorting, filtering, and faceted counts.",
@@ -140808,7 +140902,7 @@ var tokenV2ReadsContract = {
   holders,
   actions,
   events: events2,
-  holdings,
+  holdings: holdings2,
   compliance,
   conversionFeatureProbe,
   aumFeeAccruedEstimate,
@@ -143354,7 +143448,7 @@ function normalizeDalpBaseUrl(url2) {
 }
 var package_default = {
   name: "@settlemint/dalp-sdk",
-  version: "3.0.7-main.28619722466",
+  version: "3.0.7-main.28622819856",
   private: false,
   description: "Fully typed SDK for the DALP tokenization platform API",
   homepage: "https://settlemint.com",
@@ -144605,7 +144699,7 @@ var failedStateSet = new Set(FAILED_TRANSACTION_STATES);
 // package.json
 var package_default2 = {
   name: "@settlemint/dalp-cli",
-  version: "3.0.7-main.28619722466",
+  version: "3.0.7-main.28622819856",
   private: false,
   description: "CLI for the Digital Asset Lifecycle Platform — manage tokens, identities, compliance, and more from the command line.",
   homepage: "https://settlemint.com",
@@ -145648,6 +145742,19 @@ participantsCommand.command("activity-stats", {
     });
   }
 });
+participantsCommand.command("holdings", {
+  description: "List a participant's indexed holdings (token × wallet) with asset class, value, and transfer verdict",
+  args: exports_external.object({ participantId: exports_external.string().describe("Participant ID") }),
+  options: paginationOptionsSchema.extend({
+    walletType: exports_external.enum(["eoa", "smart"]).optional().describe("Filter by account type (eoa = key account, smart)")
+  }),
+  run(c) {
+    return c.var.orpc.participants.holdings({
+      params: { participantId: c.args.participantId },
+      query: toCanonicalQuery(c.options, c.options.walletType ? { walletType: c.options.walletType } : undefined)
+    });
+  }
+});
 participantsCommand.command("compliance-eligibility", {
   description: "Evaluate a participant's global compliance eligibility verdict",
   args: exports_external.object({ participantId: exports_external.string().describe("Participant ID") }),

package/package.json

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