SettleMint
Developer guidesCLI

Command reference

Complete reference for all DALP CLI commands covering authentication, tokens, users, identity, KYC, system management, and more.

The DALP CLI organizes commands into domain groups. Every command that modifies state requires authentication – see Getting started to log in.

Authentication and config

Commands that do not require authentication:

CommandDescription
dalp login [--url URL]Authenticate via device authorization flow
dalp logoutRevoke API key and clear stored credentials
dalp config get [key]View configuration
dalp config set <key> <value>Update configuration

Commands that require authentication:

CommandDescription
dalp whoamiDisplay current user, wallet, and organization

Auth management

Use dalp auth to manage the sessions, API keys, and organizations available to the authenticated user. Organization member commands operate on the active organization, so switch organization context before inviting or removing members.

CommandDescription
dalp auth session-listList active sessions for the current user.
dalp auth session-revoke <sessionId>Revoke one session by session token.
dalp auth session-revoke-allRevoke all other sessions while keeping the current one.
dalp auth api-key-listList API keys for the current user.
dalp auth api-key-create <name>Create an API key with a display name.
dalp auth api-key-delete <keyId>Delete an API key by ID.
dalp auth org-listList organizations the current user belongs to.
dalp auth org-switch <organizationId>Switch the active organization.
dalp auth org-create <name> <slug>Create an organization.
dalp auth org-invite <email> [role]Invite a member to the active organization.
dalp auth org-remove-member <memberIdOrEmail>Remove a member from the active organization by ID or email.
## Sessions
dalp auth session-list
dalp auth session-revoke <sessionId>
dalp auth session-revoke-all

## API keys
dalp auth api-key-list
dalp auth api-key-create "Treasury automation"
dalp auth api-key-delete <keyId>

## Organizations
dalp auth org-list
dalp auth org-switch <organizationId>
dalp auth org-create <name> <slug>
dalp auth org-invite [email protected] member
dalp auth org-remove-member [email protected]

org-invite accepts owner or member; when omitted, the CLI uses member. If an auth command fails, verify the active login, active organization, and command arguments before retrying.


Settings and theme management

Use settings commands to inspect platform configuration and manage the active Asset Console theme:

  • Settings upsert commands require setting: upsert; settings delete commands require setting: remove.
  • Theme preview and logo-upload commands require setting: upsert.
  • Selecting the global theme requires setting: set-global-theme.
## Platform settings
dalp settings list
dalp settings read BASE_CURRENCY
dalp settings upsert --key BASE_CURRENCY --value EUR
dalp settings delete SYSTEM_ADDONS_SKIPPED
dalp settings public-config

## Organization theme
dalp settings theme-get
## Preview a partial theme diff against the current theme version.
dalp settings theme-preview --baseVersion 3 \
  --diff '{"cssVars":{"light":{"sm-accent":"#0052cc"}}}'
## Persist the theme change after reviewing the preview.
dalp settings theme-update --baseVersion 3 \
  --diff '{"cssVars":{"light":{"sm-accent":"#0052cc"}}}'

## Theme assets
dalp settings theme-upload-logo --mode light --fileName logo.png \
  --contentType image/png --fileSize 204800
dalp settings theme-proxy-upload-logo --mode favicon --fileName favicon.ico \
  --contentType image/x-icon --fileData <base64>

## Global theme selection
dalp settings global-theme-get
dalp settings global-theme-set --orgId <organizationId>

Theme asset uploads through dalp settings theme-upload-logo and dalp settings theme-proxy-upload-logo accept image/jpeg, image/png, image/svg+xml, image/webp, and image/x-icon. Both logo upload commands apply to the active organization, so switch to the target organization before uploading branding assets. The preview command accepts partial theme diffs under supported keys such as cssVars.light, cssVars.dark, logo, images, and fonts; use theme-update with the same diff to persist reviewed changes. The upload command returns storage-specific headers and a presigned PUT URL for the client upload; the proxy upload command sends base64 file data through the API and enforces a 5 MiB file-size limit.


Account state

Read indexed native-balance state for one account:

dalp account native-balance read <chainId> <address>

Use this for operations checks that need the latest indexed gas balance for an operator wallet, smart account, system contract, or asset contract. For list, filter, and history reads, use the account native balance API.


Token management

Read operations

Use token read commands to inspect token records, holders, allowances, attached features, and indexed activity before running mutations. Commands that read one token take the token contract address. Allowance reads also require the owner and spender wallet addresses.

## Token records
dalp tokens list
dalp tokens list --query <query>
dalp tokens read <address>

## Holder and allowance state
dalp tokens holder --address 0x... --holder 0x...
dalp tokens holders <address>
dalp tokens allowance --address 0x... --owner 0x... --spender 0x...

## Activity and configuration views
dalp tokens actions <address>
dalp tokens events <address>
dalp tokens denomination-assets <address>
dalp tokens compliance <address>
dalp tokens features <address>
dalp tokens metadata <address>

Create and configure

## Create a token (pass type-specific fields as JSON)
dalp tokens create --type equity --name "Acme Shares" --symbol ACME \
  --decimals 18 --countryCode 840 --json '{"maxSupply": "1000000"}'

## Supply management
dalp tokens mint --address 0x... --to 0x... --amount 1000
dalp tokens burn --address 0x... --from 0x... --amount 500
dalp tokens set-cap --address 0x... --cap 5000000

## Transfers
dalp tokens transfer --address 0x... --to 0x... --amount 100
dalp tokens forced-transfer --address 0x... --from 0x... --to 0x... --amount 50
dalp tokens approve --address 0x... --spender 0x... --amount 1000

## State control
dalp tokens pause 0x...
dalp tokens unpause 0x...

## Freeze operations
dalp tokens freeze-address --address 0x... --target 0x...
dalp tokens freeze-partial --address 0x... --target 0x... --amount 500
dalp tokens unfreeze-partial --address 0x... --target 0x... --amount 500
## freeze-address sets the holder-level freeze flag. To clear it, call the
## token address-freezes API with freeze=false.

## Recovery
dalp tokens recover-tokens --address 0x... --lostWallet 0x...
dalp tokens forced-recover --address 0x... --lostWallet 0x... --newWallet 0x...
dalp tokens recover-erc20 --address 0x... --token-address 0x... --to 0x... --amount 1000

## Maturity and redemption
dalp tokens mature --address 0x...
dalp tokens redeem --address 0x... --amount 1000

## Access control
dalp tokens grant-role --address 0x... --role supplyManagement --account 0x...
dalp tokens revoke-role --address 0x... --role supplyManagement --account 0x...

## Compliance modules
dalp tokens add-compliance-module --address 0x... --moduleAddress 0x...
dalp tokens remove-compliance-module --address 0x... --moduleAddress 0x...
dalp tokens set-compliance-module-params --address 0x... --moduleAddress 0x...

## Identity claims
dalp tokens claim-issue --address 0x... --topic 1 --claim 0x...
dalp tokens claim-revoke --address 0x... --claimId 0x...

## Metadata
dalp tokens set-metadata --address 0x... --key prospectus --value "https://..."
dalp tokens remove-metadata --address 0x... --key prospectus

## External tokens
dalp external-tokens list
dalp external-tokens register --token-address <tokenAddress> --token-type <tokenType>

## Fee configuration
dalp tokens set-aum-fee-bps --address 0x... --featureAddress 0x... --feeBps 50
dalp tokens set-aum-fee-recipient --address 0x... --featureAddress 0x... --recipient 0x...

## Collateral and yield schedule
dalp tokens update-collateral --address 0x... --amount 150 --expiryTimestamp 1735689600
dalp tokens set-yield-schedule --address 0x... --schedule 0x...

Statistics

Use token statistics commands to inspect supply, volume, holder distribution, and yield views for a token contract. Each command takes the token contract address as the positional argument.

dalp tokens stats-bond-status 0x...
dalp tokens stats-collateral-ratio 0x...
dalp tokens stats-total-supply 0x...
dalp tokens stats-supply-changes 0x...
dalp tokens stats-volume 0x...
dalp tokens stats-wallet-distribution 0x...
dalp tokens stats-yield-distribution 0x...
dalp tokens stats-yield-coverage 0x...

stats-total-supply, stats-supply-changes, and stats-volume return time-series history. stats-wallet-distribution returns holder distribution, while the yield commands return bond yield distribution and coverage views.

Token documents

Use dalp tokens documents to list, upload, download, and delete files attached to a token. The upload flow has three steps: request a presigned upload URL, upload the file with the returned PUT method and headers, then confirm the upload with the returned object key.

## List documents attached to a token
dalp tokens documents list 0x...

## Request an upload URL for an offering document
dalp tokens documents get-upload-url --address 0x... \
  --document-type prospectus \
  --file-name prospectus.pdf \
  --file-size 204800 \
  --mime-type application/pdf \
  --visibility public

## Upload the file to the returned uploadUrl before confirming it.
## Pass every returned header by repeating -H for each key/value pair.
curl -X PUT "<upload-url>" \
  -H "Content-Type: application/pdf" \
  -H "x-ms-blob-type: BlockBlob" \
  --data-binary @prospectus.pdf

## Confirm the upload with the returned object key
dalp tokens documents confirm-upload --address 0x... \
  --object-key <object-key> \
  --document-type prospectus \
  --file-name prospectus.pdf \
  --file-size 204800 \
  --mime-type application/pdf \
  --visibility public

## Download or delete an existing token document
dalp tokens documents get-download-url --address 0x... --document-id <document-id>
dalp tokens documents delete --address 0x... --document-id <document-id>

Token document uploads accept application/pdf, image/jpeg, image/png, image/webp, DOCX, and XLSX files. Document types include offering and compliance records such as prospectus, term_sheet, legal_opinion, regulatory_filing, reserve_audit, attestation_report, chain_of_custody, and other. Visibility can be public, holders, or restricted.


User management

## Read operations
dalp users list
dalp users me
dalp users events
dalp users list --query <query>
dalp users read-by-user-id <userId>
dalp users read-by-wallet <wallet>
dalp users read-by-national-id <nationalId>

## Create
dalp users create --email [email protected] --name "Jane Doe"
dalp users create-wallet

## Analytics
dalp users assets --wallet 0x...
dalp users stats --timeRange 30d
dalp users stats-user-count
dalp users stats-growth

## Admin operations
dalp users admin-list
dalp users admin-security <userId>
dalp users admin-revoke-session --sessionId <sessionId>
dalp users admin-revoke-all-sessions <userId>
dalp users admin-reset-mfa <userId>
dalp users admin-trigger-password-reset <userId>

Identity management

## Lifecycle
dalp identities list
dalp identities me
dalp identities create --wallet 0x...
dalp identities register --wallet 0x... --country DE
dalp identities register-pending --wallet 0x...

## Lookups
dalp identities read-by-wallet <wallet>
dalp identities read-by-id <identityAddress>
dalp identities search --wallet 0x... --address 0x...
dalp identities registration-status <wallet>
dalp identities keys <identityAddress>
dalp identities keys <identityAddress> --filter purpose=management

## Management
dalp identities delete <wallet>
dalp identities update-country --wallet 0x... --countryCode US

## Claims
dalp identities claim-history <identityAddress>
dalp identities claim-issue --targetIdentityAddress 0x... --topic 1 --claimData 0x...
dalp identities claim-revoke --targetIdentityAddress 0x... --claimTopic 1

identities keys reads indexed ERC-734 keys for one identity contract. The result can be filtered by key purpose, including management, deposit, claimSigner, and encryption.


Compliance provider integrations

Use dalp compliance-providers to manage compliance-provider integrations and subject-monitoring workflows from automation scripts or operator terminals. Commands that accept --payload expect a JSON body that matches the linked compliance-provider API request.

CommandDescription
dalp compliance-providers listList configured compliance-provider integrations.
dalp compliance-providers read <integrationId>Read one provider integration by ID.
dalp compliance-providers validate-credentialsCheck provider credentials before creating integration.
dalp compliance-providers createCreate a provider integration from a JSON payload.
dalp compliance-providers rotate-secret <id>Start webhook signing-secret rotation.
dalp compliance-providers promote-secret <id>Promote the pending signing secret to active.
dalp compliance-providers cancel-secret-rotation <id>Cancel a pending signing-secret rotation.
dalp compliance-providers revoke <integrationId>Revoke an integration.
dalp compliance-providers retry-provisioning <id>Retry failed integration provisioning.
dalp compliance-providers pause <integrationId>Pause an active integration.
dalp compliance-providers resume <integrationId>Resume a paused integration.
dalp compliance-providers health <integrationId>Health-check stored credentials.
dalp compliance-providers monitoring <integrationId>List monitoring alerts for an integration.
dalp compliance-providers create-applicantCreate a provider applicant and DALP subject mapping.
dalp compliance-providers register-walletRegister a wallet or ComplyAdvantage entity-search subject using the documented subjectHints payload.
dalp compliance-providers register-transactionRegister a transaction for provider monitoring.
## Inspect and health-check integrations
dalp compliance-providers list
dalp compliance-providers read <integrationId>
dalp compliance-providers health <integrationId>
dalp compliance-providers monitoring <integrationId>

## Validate credentials, then create the integration with the API request payload
dalp compliance-providers validate-credentials --payload '<credentials-json>'
dalp compliance-providers create --payload '<integration-json>'

## Rotate webhook signing secrets without interrupting the active secret
dalp compliance-providers rotate-secret <integrationId> --secret <new-secret>
dalp compliance-providers promote-secret <integrationId>

## Register provider subjects and transactions
dalp compliance-providers create-applicant --payload '{...}'
dalp compliance-providers register-wallet --payload '{...}'
dalp compliance-providers register-transaction --payload '{...}'

For provider-specific payload fields, subject mappings, webhook events, and response shapes, see Compliance provider API and Compliance provider subjects.


KYC management

## Profile
dalp kyc profile <userId>

## Versions
dalp kyc versions <userId>
dalp kyc version-create <userId>
dalp kyc version-read --versionId <versionId>
dalp kyc version-update --versionId <versionId>
dalp kyc version-submit --versionId <versionId>
dalp kyc version-approve --versionId <versionId>
dalp kyc version-reject --versionId <versionId> --rejectionReason "..."
dalp kyc version-request-update --versionId <versionId> --reason "..."

## Documents
dalp kyc documents --versionId <versionId>
dalp kyc document-confirm-upload --versionId <versionId> --filePath ./scan.pdf \
  --documentType passport --fileName scan.pdf --fileSize 204800 --mimeType application/pdf
dalp kyc document-download-url --versionId <versionId> --documentId <docId>
dalp kyc document-delete --versionId <versionId> --documentId <docId>

## Action requests
dalp kyc action-request-fulfill <requestId>

KYC document uploads support files up to 25 MiB. The CLI reads the local file, base64-encodes it, and sends the bytes through DAPI so DALP can validate and encrypt the document before storing it.


Actions

Use dalp actions list to inspect the operational action feed from a terminal. The command returns the authenticated user's visible pending, upcoming, executed, and expired actions without applying additional CLI-side filters.

CommandDescription
dalp actions listList action records visible to the active user and organization context
## Review the action feed returned by the API.
dalp actions list

Each action includes its canonical action type, display name, status, activation time, source, and target address when the action targets an on-chain contract or wallet. For the operator workflow in the portal, see Actions work queue.


System management

Core

dalp system list
dalp system create
dalp system read <systemAddress>
dalp system resume
dalp system directory
dalp system entities

Use the core system commands to confirm the system context before you run system-scoped commands. list returns the systems available to the active organization, read inspects one system by address, and directory returns the active directory contract addresses plus supported token, compliance module, and add-on types. entities lists the identities registered inside that system context.

The directory exposes the factory and implementation addresses used to create systems. After a system exists, read returns that system's own registry addresses for assets, roles, identities, compliance modules, feeds, and trusted issuers. Read the target system before changing those resources so the following commands affect the intended system context. For the architecture model behind this boundary, see System context.

Access control

dalp system access-manager roles-list
dalp system access-manager roles-read <address>
dalp system access-manager grant-role --account 0x... --role admin
dalp system access-manager revoke-role --account 0x... --role admin

Token factories

dalp system factories list
dalp system factories available --type equity --name "My Token" --symbol MTK --decimals 18
dalp system factories create --factories '[...]'
dalp system factories read <address>
dalp system factories predict-address --type equity --name "My Token" --symbol MTK --decimals 18
dalp system factories predict-access-manager-address --type equity --name "My Token" --symbol MTK --decimals 18

Data feeds

Use feed commands to discover registered feeds, inspect indexed issuer-signed feeds and adapters, read current values, and submit feed updates.

## Discovery
dalp system feeds capabilities
dalp system feeds list
dalp system feeds resolve <subject>
dalp system feeds read <address>
dalp system feeds issuer-signed-list
dalp system feeds adapter-list

## CRUD
dalp system feeds issuer-signed-create --subject "ETH/USD" --description "Ether price" \
  --decimals 8 --historyMode rolling --historySize 100
dalp system feeds adapter-create "ETH/USD"
dalp system feeds register-external --subject "ETH/USD" --feedAddress 0x...
dalp system feeds replace --subject "ETH/USD" --newFeedAddress 0x...
dalp system feeds remove <subject>

## Data
dalp system feeds latest <address>
dalp system feeds round --address 0x... --roundId 5
dalp system feeds staleness --address 0x... --maxAgeSeconds 3600
dalp system feeds config <address>

## Updates
dalp system feeds nonce --address 0x... --issuerIdentity 0x...
dalp system feeds submit --address 0x... --value 185000000000 --observedAt "2024-06-15T12:00:00Z"

The list commands return indexed feed or adapter records for automation that needs to confirm factory-created resources.

Compliance

dalp system compliance-modules list
dalp system compliance-modules create --complianceModules '[...]'
dalp system compliance-modules remove-global --module 0x...

Trusted issuers

dalp system trusted-issuers list
dalp system trusted-issuers read <address>
dalp system trusted-issuers create --issuerAddress 0x... --claimTopicIds '[1,2]'
dalp system trusted-issuers update --address 0x... --claimTopicIds '[1,2,3]'
dalp system trusted-issuers upsert --address 0x... --claimTopicIds '[1,2]'
dalp system trusted-issuers delete <address>
dalp system trusted-issuers topics <address>

System statistics

Use dalp system stats when an operations script needs system-level portfolio, asset, identity, claim, transaction, trusted issuer, topic scheme, or value snapshots without calling the API directly. Range commands require --interval (day or hour), --from, and --to. Preset commands accept trailing24Hours or trailing7Days.

## Assets and activity
dalp system stats assets
dalp system stats asset-lifecycle-by-range --interval day --from 2024-01-01 --to 2024-12-31
dalp system stats asset-lifecycle-by-preset trailing7Days
dalp system stats asset-activity-by-range --interval hour --from 2024-06-01 --to 2024-06-02
dalp system stats asset-activity-by-preset trailing24Hours

## Identities, claims, and issuers
dalp system stats identity-count
dalp system stats identity-over-time-by-range --interval day --from 2024-01-01 --to 2024-12-31
dalp system stats identity-over-time-by-preset trailing7Days
dalp system stats claims-by-range --interval day --from 2024-01-01 --to 2024-12-31
dalp system stats claims-by-preset trailing7Days
dalp system stats claims-state
dalp system stats trusted-issuer-by-range --interval day --from 2024-01-01 --to 2024-12-31
dalp system stats trusted-issuer-by-preset trailing7Days
dalp system stats trusted-issuer-state

## Portfolio and value
dalp system stats value
dalp system stats portfolio-by-range --interval day --from 2024-01-01 --to 2024-12-31
dalp system stats portfolio-by-preset trailing7Days
dalp system stats portfolio-details
dalp system stats system-value-history-by-range --interval day --from 2024-01-01 --to 2024-12-31
dalp system stats system-value-history-by-preset trailing7Days

## Coverage and counts
dalp system stats country-asset-count
dalp system stats transaction-count
dalp system stats transaction-history
dalp system stats topic-schemes-by-range --interval day --from 2024-01-01 --to 2024-12-31
dalp system stats topic-schemes-by-preset trailing7Days
dalp system stats topic-schemes-state
dalp system stats topic-scheme-claims-coverage

Webhook operations

Use dalp webhooks to manage endpoints, signing secrets, replay, local forwarding, and synthetic test events from automation scripts or local integration tests. Endpoint creation only accepts the thin payload shape. To switch an endpoint to fat, update the endpoint with --payload-shape fat and the complete --ack-field list for the endpoint's subscriptions.

## Endpoints
dalp webhooks endpoints list
dalp webhooks endpoints read <endpointId>
dalp webhooks endpoints create --url https://example.com/webhooks --name "Ops webhook" \
  --subscription "token.transfer.*" --payload-shape thin --counter-signed-receipts true
dalp webhooks endpoints update <endpointId> --payload-shape fat \
  --ack-field token.transfer.final.from --ack-field token.transfer.final.to \
  --ack-field token.transfer.pending.from --ack-field token.transfer.pending.to
dalp webhooks endpoints delete <endpointId>

## Replay and local development
dalp webhooks replay event <evtId> --endpoint <endpointId>
dalp webhooks replay range --endpoint <endpointId> --chain-id 1 --from-block 1000 --to-block 1200
dalp webhooks replay fixture --type token.transfer.final
dalp webhooks listen start --endpoint <endpointId> --forward http://127.0.0.1:3000/webhooks
## Use --poll-ms to change the delivery polling interval from the 2000 ms default

## Signing secrets and test events
dalp webhooks secrets rotate --endpoint <endpointId>
dalp webhooks secrets revoke-previous --endpoint <endpointId>
dalp webhooks test-event send --endpoint <endpointId> --type token.transfer.final

Local forwarding prints an ephemeral signing secret for your local verifier and polls pending or failed deliveries for the selected endpoint. For route schemas, delivery details, and payload-shape rules, see Webhook endpoints API.


Token sale commands

Use dalp token-sales to inspect and operate token-sale lifecycle tasks from an operator terminal. Create the sale first, configure optional sale controls before activation, then use the lifecycle commands to activate, pause, end, finalize, and settle buyer or issuer withdrawals. Amount fields use raw units: scale sale-token caps, purchase limits, soft caps, and minimum token amounts to the sale token decimals, and scale buy --amount to the selected payment currency decimals.

CommandUse it for
dalp token-sales listList token sales for the active tenant.
dalp token-sales read <address>Read one token sale by sale contract address.
dalp token-sales createCreate a token sale for a token with start time, duration, and hard cap.
dalp token-sales activate <address>Activate a configured token sale.
dalp token-sales buyBuy tokens in a sale with a payment currency and minimum token amount.
dalp token-sales configure-vestingSet vesting start, duration, and cliff for the sale.
dalp token-sales pause <address> / unpause <address>Pause or resume sale activity.
dalp token-sales end <address> / finalize <address>End the sale window and finalize sale accounting.
dalp token-sales withdraw-fundsWithdraw collected funds for one payment currency.
dalp token-sales withdraw-tokens <address>Withdraw purchased tokens.
dalp token-sales withdraw-unsold-tokensWithdraw unsold tokens to a recipient.
dalp token-sales acknowledge-terms <address>Record the caller's acknowledgement of the sale terms.
dalp token-sales claim-refundClaim a refund for one payment currency from a failed sale.
dalp token-sales add-to-presale-whitelist / remove-from-presale-whitelistAdd or remove one wallet from the presale whitelist.
dalp token-sales add-payment-currency / remove-payment-currencyAdd or remove an accepted payment currency.
dalp token-sales set-soft-capSet the sale soft cap.
dalp token-sales set-purchase-limitsSet minimum and maximum purchase amounts.
dalp token-sales set-terms-hashStore the terms hash used for buyer acknowledgement.
## Create a sale for a token.
dalp token-sales create \
  --token-address 0x... \
  --sale-start 2026-06-01T09:00:00.000Z \
  --sale-duration 604800 \
  --hard-cap 1000000000000000000000000

## Configure sale controls before activation.
dalp token-sales add-payment-currency --address 0x... --currency 0x... --price-ratio 1000000000000000000
dalp token-sales remove-payment-currency --address 0x... --currency 0x...
dalp token-sales add-to-presale-whitelist --address 0x... --wallet 0x...
dalp token-sales remove-from-presale-whitelist --address 0x... --wallet 0x...
dalp token-sales set-purchase-limits --address 0x... --min-purchase 100000000000000000000 --max-purchase 10000000000000000000000
dalp token-sales set-soft-cap --address 0x... --soft-cap 250000000000000000000000
dalp token-sales set-terms-hash --address 0x... --terms-hash 0x...
dalp token-sales configure-vesting \
  --address 0x... \
  --vesting-start 2026-06-08T09:00:00.000Z \
  --vesting-duration 31536000 \
  --vesting-cliff 2592000

## Operate the sale lifecycle.
dalp token-sales activate 0x...
dalp token-sales pause 0x...
dalp token-sales unpause 0x...
dalp token-sales buy --address 0x... --amount 1000000000 --currency 0x... --min-token-amount 990000000000000000000
dalp token-sales end 0x...
dalp token-sales finalize 0x...

## Settle proceeds, unsold tokens, purchased tokens, or refunds.
dalp token-sales withdraw-funds --address 0x... --currency 0x... --recipient 0x...
dalp token-sales withdraw-unsold-tokens --address 0x... --recipient 0x...
dalp token-sales withdraw-tokens 0x...
dalp token-sales claim-refund --address 0x... --currency 0x...

For the underlying sale capability and operator roles, see Token Sale and Asset contract roles.


Identity recovery

Use dalp identity-recoveries when an operator needs to preview, submit, or check wallet recovery for a user through the CLI. Preview first, then execute only after the output confirms the selected user and wallet are recoverable.

CommandDescription
dalp identity-recoveries preview <userId>Show whether DALP's default selected wallet can be recovered.
dalp identity-recoveries preview <userId> <wallet>Show recovery impact for a specific lost wallet address.
dalp identity-recoveries execute <userId> [wallet]Submit the recovery workflow after preview confirms recovery can proceed.
dalp identity-recoveries status <userId>Check workflow progress and any token-level recovery failures.
## Preview the recovery impact for DALP's default selected wallet
dalp identity-recoveries preview user_123

## Preview recovery for a specific lost wallet
dalp identity-recoveries preview user_123 0x1000000000000000000000000000000000000001

## Submit the recovery workflow
dalp identity-recoveries execute user_123 0x1000000000000000000000000000000000000001

## Check recovery progress and token-level failures
dalp identity-recoveries status user_123

For response fields, permissions, and recovery status meanings, see Identity recovery API.


Compliance template commands

Use dalp compliance-templates to manage reusable compliance module templates from the CLI. Published templates are available during asset creation; draft templates can be edited before publication.

CommandDescription
dalp compliance-templates listList compliance templates for the active tenant.
dalp compliance-templates read <id>Read one compliance template by template ID.
dalp compliance-templates createCreate a draft compliance template.
dalp compliance-templates updateUpdate an existing compliance template.
dalp compliance-templates publish <id>Publish a template for asset creation.
dalp compliance-templates delete <id>Delete a compliance template.
## List compliance templates
dalp compliance-templates list

## Create a draft template
dalp compliance-templates create --name "Transfer approval policy"

## Rename a template before publishing
dalp compliance-templates update --id <template-id> --name "Transfer approval policy v2"

## Publish the template for asset creation
dalp compliance-templates publish <template-id>

For module fields, template status, compatibility rules, and API response details, see Compliance templates API.


Fixed yield schedule commands

Use dalp fixed-yield-schedules to create and operate fixed yield schedules from automation scripts. A schedule is addressed by its fixed yield contract address after creation. Yield rates use basis points, where 100 means 1%. Creation accepts HOURLY, DAILY, WEEKLY, MONTHLY, QUARTERLY, SEMI_ANNUAL, or YEARLY as the payment interval, plus an ISO 3166-1 numeric country code.

CommandDescription
dalp fixed-yield-schedules read <address>Read one fixed yield schedule.
dalp fixed-yield-schedules createCreate a fixed yield schedule for a token.
dalp fixed-yield-schedules top-upDeposit payout assets into a schedule.
dalp fixed-yield-schedules withdrawWithdraw payout assets from a schedule.
dalp fixed-yield-schedules claim <address>Claim available yield rewards.
## Create a schedule for a token.
dalp fixed-yield-schedules create \
  --token 0x... \
  --yield-rate 500 \
  --payment-interval QUARTERLY \
  --start-time <future-start-time> \
  --end-time <future-end-time> \
  --country-code 840

## Fund the schedule for the linked token.
dalp fixed-yield-schedules top-up \
  --address 0x... \
  --amount 1000000000000000000 \
  --token-address 0x...

## Withdraw unused schedule funds for the linked token.
dalp fixed-yield-schedules withdraw \
  --address 0x... \
  --amount 1000000000000000000 \
  --to 0x... \
  --token-address 0x...

## Claim available rewards.
dalp fixed-yield-schedules claim 0x...

--yield-rate is expressed in basis points, so 500 means 5%. --payment-interval accepts HOURLY, DAILY, WEEKLY, MONTHLY, QUARTERLY, SEMI_ANNUAL, or YEARLY. --start-time and --end-time must be future times, passed as ISO dates or Unix timestamps. For top-up and withdrawal commands, --token-address is the token contract linked to the schedule. For operational context on funding and claims, see Configure yield schedules.


XvP settlement commands

Use dalp xvp-settlements to list, inspect, and operate cross-value protocol settlements from automation scripts. XvP settlements are addressed by their settlement contract address after creation. Commands that change settlement state return a transaction hash.

CommandDescription
dalp xvp-settlements listList XvP settlements visible to the active organization.
dalp xvp-settlements read <address>Read settlement metadata, approvals, cancel votes, flows, and state.
dalp xvp-settlements decrypt <address>Decrypt the stored HTLC secret and return its hashlock.
dalp xvp-settlements createCreate an XvP settlement from a factory address and flow list.
dalp xvp-settlements approve <address>Approve one settlement as the current user.
dalp xvp-settlements revoke-approval <address>Revoke the current user's approval for one settlement.
dalp xvp-settlements execute <address>Execute a settlement that is ready for execution.
dalp xvp-settlements cancel <address>Vote to cancel one settlement.
dalp xvp-settlements withdraw-cancel <address>Withdraw the current user's cancellation proposal.
dalp xvp-settlements withdraw-expired <address>Withdraw assets from an expired settlement.
dalp xvp-settlements reveal-secretReveal the HTLC secret for one settlement.
## List and inspect XvP settlements.
dalp xvp-settlements list
dalp xvp-settlements read 0x...

## Create a local settlement. Amounts are base-unit token amounts.
dalp xvp-settlements create \
  --factory-address 0x... \
  --name "Primary market settlement" \
  --cutoff-date 2026-06-01T12:00:00.000Z \
  --flows '[{"type":"local","assetId":"0x...","from":"0x...","to":"0x...","amount":"1000000000000000000"}]'

## Approve, execute, or cancel a settlement.
dalp xvp-settlements approve 0x...
dalp xvp-settlements revoke-approval 0x...
dalp xvp-settlements execute 0x...
dalp xvp-settlements cancel 0x...

## Withdraw a cancellation proposal, or withdraw assets from an expired settlement.
dalp xvp-settlements withdraw-cancel 0x...
dalp xvp-settlements withdraw-expired 0x...

## Inspect or reveal an HTLC secret when the settlement workflow requires it.
dalp xvp-settlements decrypt 0x...
dalp xvp-settlements reveal-secret --address 0x... --secret <secret>

create requires at least one local flow. Local flows use type, assetId, from, to, and amount. External flows also include externalChainId and externalAssetDecimals. Use the API directly for XvP creation workflows that require a raw secret, precomputed hashlock, automatic execution, or a V3 factory country code.


Exchange rate commands

Use dalp exchange-rates to inspect and manage fiat exchange rates used by the active system. Currency codes use ISO currency codes such as USD and EUR.

CommandDescription
dalp exchange-rates listList exchange rates for the active system.
dalp exchange-rates read <baseCurrency> <quoteCurrency>Read one exchange rate pair.
dalp exchange-rates updateSet a manual rate for one currency pair.
dalp exchange-rates delete <baseCurrency> <quoteCurrency>Delete one manual exchange rate override.
dalp exchange-rates syncRefresh exchange rates from the configured source.
dalp exchange-rates history <baseCurrency> <quoteCurrency>View historical rates for one pair.
## List configured exchange rates.
dalp exchange-rates list

## Read and review one currency pair.
dalp exchange-rates read USD EUR

## Set a manual rate for one pair.
dalp exchange-rates update --base-currency USD --quote-currency EUR --rate 0.92

## Refresh rates from the configured exchange rate source.
dalp exchange-rates sync

## Check the history for one pair.
dalp exchange-rates history USD EUR

## Delete a manual override when the configured rate should fall back to provider-synced data.
dalp exchange-rates delete USD EUR

For the pricing and feeds model behind exchange rates, see Data feeds and Feeds system.


Monitoring

Use dalp monitoring to inspect API request activity and blockchain service health from an operator terminal. Commands that accept date ranges require --from and --to values. Pass ISO 8601 timestamps so the CLI can parse the range consistently.

API monitoring

CommandDescription
dalp monitoring api summary --from <date> --to <date>View total requests, errors, latency, and rates for a time range.
dalp monitoring api timeline --from <date> --to <date>View request counts grouped for charting or reporting.
dalp monitoring api endpoints --from <date> --to <date>Compare request statistics per endpoint.
dalp monitoring api logs --from <date> --to <date>List raw request log entries for a time range.
dalp monitoring api logs-streamStream new request log entries as server-sent events.
dalp monitoring api detail <requestId>Read the full detail for one request log entry.
## Review API activity for a reporting window.
dalp monitoring api summary --from 2026-05-01T00:00:00.000Z --to 2026-05-01T12:00:00.000Z
dalp monitoring api timeline --from 2026-05-01T00:00:00.000Z --to 2026-05-01T12:00:00.000Z
dalp monitoring api endpoints --from 2026-05-01T00:00:00.000Z --to 2026-05-01T12:00:00.000Z

## Inspect request logs, or stream new entries while testing an integration.
dalp monitoring api logs --from 2026-05-01T00:00:00.000Z --to 2026-05-01T12:00:00.000Z
dalp monitoring api logs-stream
dalp monitoring api detail req_01HXAMPLE0000000000000000

Blockchain monitoring

CommandDescription
dalp monitoring blockchain summary --from <date> --to <date>View aggregate chain RPC and indexer health for a time range.
dalp monitoring blockchain timeline --from <date> --to <date>View health status counts grouped over time.
dalp monitoring blockchain services --from <date> --to <date>Compare per-service blockchain health metrics.
dalp monitoring blockchain snapshotsList raw blockchain health snapshots.
dalp monitoring blockchain snapshots-streamStream new blockchain health snapshots as server-sent events.
## Review chain and indexer health for a reporting window.
dalp monitoring blockchain summary --from 2026-05-01T00:00:00.000Z --to 2026-05-01T12:00:00.000Z
dalp monitoring blockchain timeline --from 2026-05-01T00:00:00.000Z --to 2026-05-01T12:00:00.000Z
dalp monitoring blockchain services --from 2026-05-01T00:00:00.000Z --to 2026-05-01T12:00:00.000Z

## Inspect or stream health snapshots.
dalp monitoring blockchain snapshots
dalp monitoring blockchain snapshots-stream

For the operational workflow behind blockchain monitoring, see Blockchain monitoring.


Contact commands

Use dalp contacts to maintain the authenticated user's contact entries. Contacts store a human-readable name and an EVM wallet address so scripts and operators can reuse known counterparties when preparing transfers, recovery actions, and other wallet-based workflows.

CommandDescription
dalp contacts list [--query <query>]List contacts. The optional query searches contact names and wallet values.
dalp contacts read <id>Read one contact by contact ID.
dalp contacts upsert --name <name> --wallet <wallet>Create a contact or update the existing contact for the same wallet.
dalp contacts delete <id>Delete one contact by contact ID.
## Find existing contacts.
dalp contacts list
dalp contacts list --query treasury

## Read one contact returned by the list command.
dalp contacts read <contactId>

## Save or update a contact for an EVM wallet address.
dalp contacts upsert --name "Treasury Wallet" --wallet 0x...

## Remove a contact that should no longer appear in Contacts results.
dalp contacts delete <contactId>

Contact names must be 1 to 120 characters after trimming, and wallets must be valid EVM addresses. Contacts follow the authenticated user. Upserting a wallet that already exists for that user updates the contact instead of creating a duplicate.


Blockchain transaction commands

Use dalp blockchain-transactions to inspect an on-chain transaction by hash from the active DALP API context. The command returns the transaction hash, sender address, and receipt details when the transaction has been mined. Pending transactions return a null receipt.

CommandDescription
dalp blockchain-transactions read <hash>Read transaction details by transaction hash

Example:

dalp blockchain-transactions read 0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef

Asset type template commands

Use dalp asset-type-templates to list, inspect, create, update, publish, or delete asset type templates from an operator terminal.

Asset type templates define reusable asset-type entries for the asset creation flow. A template can point to a known deployable asset type, such as bond or deposit. It can also point to a custom type ID backed by an asset class definition.

CommandDescription
dalp asset-type-templates listList asset type templates.
dalp asset-type-templates read <id>Read an asset type template by template ID.
dalp asset-type-templates create --name <name> --type-id <typeId> [--base-asset-type <assetType>] [--asset-class-id <assetClassId>]Create an asset type template. Custom type IDs require an asset class ID; the base asset type is an optional override.
dalp asset-type-templates update --id <id> [--name <name>] [--type-id <typeId>] [--base-asset-type <assetType>] [--asset-class-id <assetClassId>]Update an asset type template. Optional fields include name, type ID, base asset type, and asset class ID.
dalp asset-type-templates publish <id>Publish a draft asset type template.
dalp asset-type-templates delete <id>Delete an asset type template by template ID.
## Review the current templates.
dalp asset-type-templates list

dalp asset-type-templates read <templateId>

## Create a custom template backed by an asset class definition.
dalp asset-type-templates create \
  --name "Senior secured note" \
  --type-id senior-secured-note \
  --base-asset-type bond \
  --asset-class-id <asset-class-id>

## Publish the template after review.
dalp asset-type-templates publish <templateId>

For known asset type IDs, DALP can derive the base asset type when the option is omitted. For custom type IDs, provide an asset class ID to link the template to a managed asset class.


dalp search-results <query> runs the same global search used by the platform search surface. The query must be at least 2 characters and no more than 120 characters.

## Search for matching records across searchable DALP resources
dalp search-results "bond"

Results are grouped by resource type. Current grouped sections include contacts, tokens, and users when the authenticated user can see matching records in the active system.


Admin commands

Use dalp admin organizations list to review organisations through the active DALP API context.

The command is for cross-organisation platform administration. It is not a tenant-scoped address book or participant list.

CommandDescription
dalp admin organizations listList organisations for platform admins
## List organisations visible to the platform administrator account.
dalp admin organizations list

The command requires permission to list organisations. The API returns a paginated collection with each organisation's identifier, name, slug, logo URL, creation time, owner count, owner emails, member count, and asset count.


Other commands

CommandDescription
dalp search-results <query>Global platform search
dalp actionsToken action management
dalp asset-type-templatesAsset type templates
dalp asset-type-templates listList asset type templates.
dalp asset-type-templates read <id>Read an asset type template by template ID.
dalp asset-type-templates create --name <name> --type-id <typeId> [--base-asset-type <assetType>] [--asset-class-id <assetClassId>]Create an asset type template. Custom type IDs require an asset class ID; the base asset type is an optional override.
dalp asset-type-templates update --id <id> [--name <name>] [--type-id <typeId>] [--base-asset-type <assetType>] [--asset-class-id <assetClassId>]Update an asset type template. Optional fields include name, type ID, base asset type, and asset class ID.
dalp asset-type-templates publish <id>Publish a draft asset type template.
dalp asset-type-templates delete <id>Delete an asset type template by template ID.
dalp compliance-templatesCompliance module templates
dalp contactsContact management
dalp exchange-ratesFiat exchange rate data
dalp external-tokensExternal token integration
dalp fixed-yield-schedulesFixed yield operations
dalp identity-recoveriesIdentity recovery workflows
dalp monitoringSystem health monitoring
dalp settingsUser settings management
dalp tokens documentsToken-level document management
dalp token-salesToken sale lifecycle
dalp blockchain-transactionsTransaction tracking and status
dalp xvp-settlementsXvP settlement operations

Global options

All commands accept:

OptionDescription
--format <format>Output format: toon, json, yaml, jsonl, md
--jsonShorthand for --format json
--helpShow help for the command

Special flags for agent integration:

FlagDescription
--mcpStart CLI as an MCP stdio server
--llmsOutput Markdown skill manifest
--schemaOutput JSON Schema manifest

Exit codes

CodeMeaning
0Success
1General error (validation, network, permission)

On this page