@settlemint/dalp-cli 3.0.6-main.28327872648 → 3.0.6-main.28328698423

package/dist/dalp.js

@@ -139797,6 +139797,81 @@ var TokenRecipientEligibilityResponseSchema = exports_external.object({
     description: "The action the verdict applies to."
   })
 });
+var TokenTransferSimulateParamsSchema = exports_external.object({
+  tokenAddress: TokenReadInputSchema.shape.tokenAddress
+});
+var TokenTransferSimulateQuerySchema = exports_external.object({
+  from: ethereumAddress.meta({
+    description: "Sender address for the simulated transfer.",
+    examples: ["0x71C7656EC7ab88b098defB751B7401B5f6d8976F"]
+  }),
+  to: ethereumAddress.meta({
+    description: "Recipient address for the simulated transfer.",
+    examples: ["0xabc0000000000000000000000000000000000001"]
+  }),
+  amount: assetAmount.meta({
+    description: "Token amount to simulate, expressed as a stringified integer in the token's smallest unit.",
+    examples: ["1000000000000000000"]
+  })
+});
+var ComplianceFailureReasonSchema = exports_external.enum(["identity-not-registered", "identity-not-verified", "module-blocked"]).meta({
+  description: "Root compliance failure class. `identity-not-registered`: the party has no identity entry in the registry. `identity-not-verified`: identity exists but required claims are missing or expired. `module-blocked`: the module actively blocks the address (freeze, blocklist, country bar)."
+});
+var RemediationClassSchema = exports_external.enum(["self-serve", "operator", "structural"]).meta({
+  description: "`self-serve`: investor can unblock by acquiring the required claims. `operator`: a platform operator must act (unfreeze, remove from blocklist, register identity). `structural`: not currently unblockable via a standard workflow."
+});
+var IssueClaimRemediationSchema = exports_external.object({
+  kind: exports_external.literal("issue-claim"),
+  topics: exports_external.array(exports_external.string().min(1)).min(1).meta({
+    description: "Claim topics the party must satisfy to unblock the transfer. Any single satisfied path clears the rule when the expression is disjunctive."
+  })
+});
+var OperatorActionRemediationSchema = exports_external.object({
+  kind: exports_external.literal("operator-action"),
+  action: exports_external.enum(["unfreeze", "remove-blocklist", "register-identity"]).meta({
+    description: "The named operator action that unblocks the transfer."
+  })
+});
+var NoRemediationSchema = exports_external.object({
+  kind: exports_external.literal("none")
+});
+var TransferRemediationSchema = exports_external.discriminatedUnion("kind", [IssueClaimRemediationSchema, OperatorActionRemediationSchema, NoRemediationSchema]).meta({
+  description: "Actionable remediation for the blocker. `issue-claim`: investor acquires required claims; `operator-action`: operator takes a named administrative action; `none`: no standard workflow resolves this blocker."
+});
+var TransferSimulationBlockerSchema = exports_external.object({
+  code: exports_external.string().min(1).meta({
+    description: "Machine-readable blocker code. Matches the compliance module's revert selector or an internal classifier code (e.g. `unrecognized-rule`) for modules that could not be identified."
+  }),
+  moduleTypeId: complianceTypeId().meta({
+    description: "TypeId of the compliance module that raised this blocker."
+  }),
+  moduleInstance: ethereumAddress.meta({
+    description: "On-chain address of the specific module instance that raised this blocker."
+  }),
+  party: exports_external.enum(["sender", "recipient"]).meta({
+    description: "Which transfer party this blocker is attributed to."
+  }),
+  reason: ComplianceFailureReasonSchema,
+  remediationClass: RemediationClassSchema,
+  remediation: TransferRemediationSchema,
+  topics: exports_external.array(exports_external.string()).optional().meta({
+    description: "Claim topics relevant to this blocker. Populated when the failure reason is claim-related."
+  })
+}).meta({
+  description: "A single compliance blocker for the simulated transfer, with the attributed party, failure reason, and actionable remediation."
+});
+var TokenTransferSimulateResponseSchema = exports_external.object({
+  verdict: exports_external.enum(["will-clear", "will-revert"]).meta({
+    description: "`will-clear`: the on-chain `canTransfer` call succeeded — the transfer will go through. `will-revert`: the call reverted; see `blockers` for the classified causes.",
+    examples: ["will-clear", "will-revert"]
+  }),
+  blockers: exports_external.array(TransferSimulationBlockerSchema).meta({
+    description: "Classified list of compliance blockers. Empty when `verdict` is `will-clear`. At least one entry when `verdict` is `will-revert` (last entry is an `unrecognized-rule` catch-all when no specific module could be attributed)."
+  })
+}).meta({
+  description: "Result of the transfer simulation. The verdict is sourced exclusively from the on-chain `canTransfer` call, never from the blocker enumeration."
+});
+var TokenTransferSimulateOutputSchema = createSingleResponse(TokenTransferSimulateResponseSchema);
 var InheritedGlobalControlsV2InputSchema = exports_external.object({
   tokenAddress: ethereumAddress.meta({
     description: "The token contract address whose inherited global controls are evaluated.",
@@ -141136,6 +141211,13 @@ var recipientEligibility = v2Contract.route({
   successDescription: "Eligibility verdict for the address resolved.",
   tags: [V2_TAG.token]
 }).input(v2Input.paramsQuery(TokenRecipientEligibilityParamsSchema, TokenRecipientEligibilityQuerySchema)).output(createSingleResponse(TokenRecipientEligibilityResponseSchema));
+var transferSimulate = v2Contract.route({
+  method: "GET",
+  path: "/tokens/{tokenAddress}/transfer-simulate",
+  description: "Simulate a token transfer by executing the on-chain `canTransfer(from, to, amount)` call. Returns an authoritative verdict (`will-clear` or `will-revert`) and, on revert, a classified list of compliance blockers with per-blocker remediation metadata. The verdict is always derived from the on-chain result; the blocker list is informational.",
+  successDescription: "Transfer simulation verdict and classified blocker list resolved.",
+  tags: [V2_TAG.token]
+}).input(v2Input.paramsQuery(TokenTransferSimulateParamsSchema, TokenTransferSimulateQuerySchema)).output(createSingleResponse(TokenTransferSimulateResponseSchema));
 var inheritedGlobalControls = v2Contract.route({
   method: "GET",
   path: "/tokens/{tokenAddress}/inherited-global-controls",
@@ -141427,6 +141509,7 @@ var tokenV2ReadsContract = {
   read: read33,
   allowance,
   recipientEligibility,
+  transferSimulate,
   inheritedGlobalControls,
   holder,
   holders,
@@ -143978,7 +144061,7 @@ function normalizeDalpBaseUrl(url2) {
 }
 var package_default = {
   name: "@settlemint/dalp-sdk",
-  version: "3.0.6-main.28327872648",
+  version: "3.0.6-main.28328698423",
   private: false,
   description: "Fully typed SDK for the DALP tokenization platform API",
   homepage: "https://settlemint.com",
@@ -145198,7 +145281,7 @@ var failedStateSet = new Set(FAILED_TRANSACTION_STATES);
 // package.json
 var package_default2 = {
   name: "@settlemint/dalp-cli",
-  version: "3.0.6-main.28327872648",
+  version: "3.0.6-main.28328698423",
   private: false,
   description: "CLI for the Digital Asset Lifecycle Platform — manage tokens, identities, compliance, and more from the command line.",
   homepage: "https://settlemint.com",
@@ -211717,6 +211800,20 @@ function registerTokenReads(cmd) {
         params: { tokenAddress: c.options.address }
       });
     }
+  }).command("transfer-simulate", {
+    description: "Simulate a token transfer and return the compliance verdict with classified blockers",
+    options: exports_external.object({
+      address: exports_external.string().describe("Token contract address"),
+      from: exports_external.string().describe("Sender address for the simulated transfer"),
+      to: exports_external.string().describe("Recipient address for the simulated transfer"),
+      amount: exports_external.string().describe("Transfer amount in the token's smallest unit (integer string)")
+    }),
+    run(c) {
+      return c.var.orpc.token.transferSimulate({
+        params: { tokenAddress: c.options.address },
+        query: { from: c.options.from, to: c.options.to, amount: c.options.amount }
+      });
+    }
   }).command("holder", {
     description: "Get token holder details",
     options: exports_external.object({

package/package.json

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