Splice
0.4.4

Deployment and Operations

  • Overview
  • Validators
    • Validator Onboarding Process
      • Networks
      • Onboarding Process Overview
      • Validating that your IP has been approved
      • Stay Connected
        • Slack
        • Mailing Lists
    • Validator Hardware Requirements
      • Database Latency
    • Docker Compose-Based Deployment of a Validator Node
      • Requirements
      • Required Network Parameters
      • Deployment
      • Logging into the wallet UI
      • Logging into the CNS UI
      • Configuring Authentication
      • Integration with systemd and other init systems
    • Kubernetes-Based Deployment of a Validator node
      • Requirements
        • Required Network Parameters
      • Validator Network Diagram
      • Preparing a Cluster for Installation
      • Configuring PostgreSQL authentication
      • Preparing for Validator Onboarding
      • Configuring Authentication
        • OIDC Provider Requirements
        • Configuring an Auth0 Tenant
        • Configuring Authentication on your Validator
      • Installing the Software
        • Configuring the Helm Charts
        • Installing the Helm Charts
      • Configuring the Cluster Ingress
        • Requirements
        • Installation Instructions
      • Logging into the wallet UI
      • Configuring automatic traffic purchases
      • Configuring sweeps and auto-accepts of transfer offers
      • Logging into the CNS UI
      • Participant Pruning
    • Upgrades
      • Synchronizer Upgrades with Downtime
        • Overview
        • Technical Details
          • State and Migration IDs
          • Migration Dumps
          • Catching Up Before the Migration
          • Deploying the Validator App and Participant
            • Deploying the Validator App and Participant (Kubernetes)
            • Deploying the validator App and Participant (Docker-Compose)
        • Cleanup in the event of failure
    • Network Resets of DevNet and Testnet
    • Backups
      • Backup of Node Identities
      • Backups of postgres instances
        • Historical backups
    • Disaster Recovery
      • Restoring a validator from backups
      • Re-onboard a validator and recover balances of all users it hosts
        • Kubernetes Deployment
        • Docker-Compose Deployment
        • Limitations and Troubleshooting
      • Recover the Coin balance of an external party
      • Disaster recovery from loss of the CometBFT storage layer of the global synchronizer
        • Technical Details (Kubernetes)
          • Migrating the Data
        • Technical Details (Docker-Compose)
          • Migrating the Data
    • Security Hardening
      • Using an external KMS for managing participant keys
        • Migrating an existing validator to use an external KMS
        • Configuring a fresh validator to use an external KMS
          • Google Cloud KMS
          • Amazon Web Services KMS
    • Users, Parties and Wallets in the Splice Wallet
      • Disable wallet and wallet automation
    • Validator Ingress & Egress requirements
      • Ingress
      • Egress
  • Supervalidators
    • Kubernetes-Based Deployment of a Super Validator node
      • Requirements
      • Generating an SV identity
      • Preparing a Cluster for Installation
      • Configuring Authentication
        • OIDC Provider Requirements
        • Configuring an Auth0 Tenant
        • Configuring Authentication on your SV Node
      • Configuring your CometBFT node
        • Generating your CometBFT node keys
        • Configuring your CometBFT node keys
        • Configuring CometBFT state sync
      • Installing Postgres instances
        • Creating k8s Secrets for Postgres Passwords
        • Postgres in the Cluster
        • Cloud-Hosted Postgres
      • Installing the Software
        • Configuring the Helm Charts
        • Installing the Helm Charts
      • SV Network Diagram
      • Configuring the Cluster Ingress
        • Hostnames and URLs
        • Ingress Configuration
        • Requirements
        • Installation Instructions
      • Configuring the Cluster Egress
      • Logging into the wallet UI
      • Logging into the CNS UI
      • Logging into the SV UI
      • Observing the Canton Coin Scan UI
    • Upgrades
      • Synchronizer Upgrades with Downtime
        • Overview
        • Technical Details
          • State and Migration IDs
          • Migration Dumps
          • Deploying new Canton Components and CometBFT Node
          • Catching Up Before the Migration
          • Updating Apps
          • Recovering from a failed upgrade
        • Organizational Details
          • Coordination calls
        • Testing
          • Individual Preparation
          • Coordinated Tests
        • Cleanup in the event of failure
    • Network Resets of DevNet and Testnet
    • Backups
      • Backup of Node Identities
      • Backup of Postgres Instances
        • Taking backups
        • Historical backups
      • Backup of CometBFT
        • Historical backups
    • Pruning
      • Sequencer pruning
      • CometBFT pruning
    • Disaster Recovery
      • Restoring From Data Corruption
        • Restoring a single component from backups
        • Restoring a full SV node from backups
      • Re-onboard an SV and recover Amulets with a validator
      • Disaster recovery from loss of CometBFT layer
        • Technical Details
          • Finding a Consistent Timestamp to Recover the Synchronizer From
          • Creating a Data Dump from the SV App
          • Migrating the Data
    • Security Hardening
      • Third-party Daml apps
      • Using an external KMS for managing participant keys
        • Migrating an existing SV to use an external KMS for participant keys
        • Configuring a fresh SV to use an external KMS
          • External management of CometBFT governance key
            • Generating a CometBFT governance key
            • Configuring SV app to use the externally generated CometBFT governance key
          • Configuring participant to use an external KMS
            • Google Cloud KMS
            • Amazon Web Services KMS
    • SV Operations
      • Security Notice
      • Generate a validator onboarding secret
      • Identities used by SV nodes on different layers
        • SV identity
        • Participant identities
        • CometBFT node identities
      • Updating the reward weight of an SV
      • Determining good synchronizer traffic parameters
        • Determining the cost of a single CC transfer
        • Considerations around the read scaling factor
          • Lower bound
          • Upper bound
    • How to Bootstrap a Network
      • cometbft helm values
      • scan helm values
      • sv helm values
      • other helm values you may need to consider
      • Infra-level things you might want to consider
      • How to run through a HDM
  • Operations
    • Synchronizer Traffic Fees
      • Traffic accounting; what counts as traffic?
      • Traffic parameters
      • Traffic top-ups; how does one “buy” traffic?
    • Monitoring and Observability
      • Validator Health
      • Metrics
        • Scraping the metrics
          • Histograms
          • Enabling metrics
            • Configuring a helm deployment to enable metrics
            • Configuring a docker compose deployment to enable metrics
        • Grafana Dashboards
      • Metrics Reference
        • Common Metrics
          • splice.domain_params_store.confirmation-requests-max-rate
          • splice.store.signal-when-ingested-latency
          • splice.store.acs-size
          • daml.grpc.client
          • daml.grpc.client.messages.sent
          • daml.grpc.client.messages.received
          • daml.grpc.client.messages.sent.bytes
          • daml.grpc.client.messages.received.bytes
          • daml.grpc.client.started
          • daml.grpc.client.completed
          • splice.trigger.latency
          • splice.trigger.iterations
          • splice.trigger.completed
          • splice.trigger.attempted
        • Validator Metrics
          • splice.wallet.unlocked-amulet-balance
          • splice.wallet.locked-amulet-balance
        • SV Metrics
          • splice.sv_dso_store.latest-open-mining-round
          • splice.sequencer_pruning.latency
          • splice.sequencer_pruning.disabled_members
          • splice.sv_cometbft.earliest_block_height
          • splice.sv_cometbft.latest_block_height
          • splice.sv_status_report.number
          • splice.sv_status_report.creation_time_us
          • splice.sv_status_report.cometbft_height
          • splice.sv_status_report.domain_time_us
          • splice.sv_status_report.domain_time_us
          • splice.sv_status_report.latest_open_round
        • Scan Metrics
          • splice.scan_store.earliest-aggregated-round
          • splice.scan_store.latest-aggregated-round
    • Configuring deployed apps
      • Adding ad-hoc configuration
      • Custom bootstrap scripts
        • Helm charts support
    • Troubleshooting
      • Getting console access to Canton nodes
        • Participant console
        • Sequencer console
        • Mediator console
        • Access in a K8s cluster
      • Where to find logs
      • Debugging issues in Web UIs
      • Configurations
      • Common Error Messages
        • Traffic balance below reserved amount
        • Insufficient funds to buy configured traffic amount
        • Gave up getting app version
        • UNAUTHENTICATED errors in validator, sv and scan app
        • Node has identity X, but identifier Y was expected

Application Development

  • Overview
    • Canton Network Applications
    • RPC APIs Overview
    • Splice Daml APIs Overview
    • Splice Daml Models Overview
  • Version Information
    • Installing a Compatible Daml SDK
  • Testing
    • Docker-Compose Based Deployment of a Local Network
      • Setup
      • Exposed Ports
      • Database
      • Application UIs
      • Default Wallet Users
      • Swagger UI
      • Run in localnet
        • start
        • stop
        • start with swagger-ui
        • stop with swagger-ui
        • console
    • SV Operated networks and Use-cases
      • DevNet
      • TestNet
      • MainNet
    • Testing Guidelines
  • Ledger API
  • Splice HTTP APIs
    • Public HTTP APIs
      • Scan APIs
        • Scan Bulk Data API
          • Open API Specification
            • Updates
              • POST /v2/updates
                • Requesting all updates
                • Requesting updates from an arbitrary record time
                • Reading the response
                • Exercised Event
                • Created Event
            • ACS Snapshots
              • GET /v0/state/acs/snapshot-timestamp
              • POST /v0/state/acs
              • POST /v0/state/acs/force
          • Scan TxLog Script
            • Overview
            • Usage
            • Key Components
              • Processing Overview
          • Computing Total Burnt Canton Coin
            • Coin Burnt for Purchasing Traffic on the Synchronizer
            • Coin Burnt in Canton Coin Transfers
            • Purchasing CNS Entries
            • Fees Paid for Creating CC Transfer Pre-Approvals
            • Note About Daml Versions
        • Scan Global Synchronizer Connectivity API
          • Listing all SV Scans
          • Listing all SV Sequencers
          • Listing all Validators
          • Parties’ Hosting Participants
        • Scan Global Synchronizer Operations API
          • Validator Liveness
          • DSO Info
        • Scan Canton Coin Reference Data API
          • DSO party ID
        • Scan API for Current state of CC and Synchronizer Traffic
          • Validator Traffic Credits and Purchases
          • Open Mining Rounds
            • Conversion rate
          • Closed Mining Rounds
        • Scan Aggregates API
          • Amulet Summaries
          • Detailed Amulet Holdings
          • Looking up ANS Entries
        • Scan Open API Reference
          • external
          • internal
          • deprecated
          • scan
          • common
      • Validator APIs
        • User wallet API
          • Transfer Offers
          • Buying Traffic
        • Internal user wallet API
        • External Signing API
        • User management API
        • Validator management API
        • ANS API
        • Scan Proxy API
    • OpenAPI Conventions
      • API Stability
      • Contract Payload Encoding
    • Authentication
    • Port Configuration
  • Splice Daml APIs
    • Canton Network Token Standard APIs (CIP-0056)
      • splice-api-token-metadata-v1 docs
        • Splice.Api.Token.MetadataV1
          • Interfaces
          • Data Types
          • Functions
      • splice-api-token-holding-v1 docs
        • Splice.Api.Token.HoldingV1
          • Interfaces
          • Data Types
      • splice-api-token-transfer-instruction-v1 docs
        • Splice.Api.Token.TransferInstructionV1
          • Interfaces
          • Data Types
          • Functions
      • splice-api-token-allocation-request-v1 docs
        • Splice.Api.Token.AllocationRequestV1
          • Interfaces
          • Data Types
          • Functions
      • splice-api-token-allocation-instruction-v1 docs
        • Splice.Api.Token.AllocationInstructionV1
          • Interfaces
          • Data Types
          • Functions
      • splice-api-token-allocation-v1 docs
        • Splice.Api.Token.AllocationV1
          • Interfaces
          • Data Types
          • Functions
      • splice-api-token-burn-mint-v1 docs
        • Splice.Api.Token.BurnMintV1
          • Interfaces
          • Data Types
          • Functions
    • Featured App Activity Markers API (CIP-0047)
      • splice-api-featured-app-v1 docs
        • Splice.Api.FeaturedAppRightV1
          • Interfaces
          • Data Types
          • Functions
  • Splice Daml Models
    • splice-amulet docs
      • Splice.Amulet
        • Templates
        • Data Types
        • Functions
      • Splice.Amulet.TokenApiUtils
        • Typeclasses
        • Orphan Typeclass Instances
        • Data Types
        • Functions
      • Splice.Amulet.TwoStepTransfer
        • Data Types
        • Functions
      • Splice.AmuletAllocation
        • Templates
        • Functions
      • Splice.AmuletConfig
        • Data Types
        • Functions
      • Splice.AmuletRules
        • Templates
        • Data Types
        • Functions
      • Splice.AmuletTransferInstruction
        • Templates
        • Functions
      • Splice.DecentralizedSynchronizer
        • Templates
        • Data Types
        • Functions
      • Splice.Expiry
        • Data Types
        • Functions
      • Splice.ExternalPartyAmuletRules
        • Templates
        • Data Types
        • Functions
      • Splice.Fees
        • Data Types
        • Functions
      • Splice.Issuance
        • Data Types
        • Functions
      • Splice.RelRound
        • Data Types
        • Functions
      • Splice.Round
        • Templates
        • Functions
      • Splice.Schedule
        • Data Types
        • Functions
      • Splice.Types
        • Data Types
        • Functions
      • Splice.ValidatorLicense
        • Templates
        • Data Types
        • Functions
    • splice-amulet-name-service docs
      • Splice.Ans
        • Templates
        • Data Types
        • Functions
    • splice-dso-governance docs
      • Splice.CometBft
        • Data Types
        • Functions
      • Splice.DSO.AmuletPrice
        • Templates
        • Functions
      • Splice.DSO.DecentralizedSynchronizer
        • Data Types
        • Functions
      • Splice.DSO.SvState
        • Templates
        • Data Types
      • Splice.DsoBootstrap
        • Templates
        • Data Types
      • Splice.DsoRules
        • Templates
        • Orphan Typeclass Instances
        • Data Types
        • Functions
      • Splice.SvOnboarding
        • Templates
        • Data Types
    • splice-util docs
      • Splice.Util
        • Typeclasses
        • Functions
    • splice-validator-life-cycle docs
      • Splice.ValidatorOnboarding
        • Templates
        • Data Types
    • splice-wallet docs
      • Splice.Wallet.BuyTrafficRequest
        • Templates
        • Data Types
      • Splice.Wallet.Install
        • Templates
        • Data Types
        • Functions
      • Splice.Wallet.TopUpState
        • Templates
        • Functions
      • Splice.Wallet.TransferOffer
        • Templates
        • Data Types
      • Splice.Wallet.TransferPreapproval
        • Templates
        • Data Types
    • splice-wallet-payments docs
      • Splice.Wallet.Payment
        • Templates
        • Data Types
        • Functions
      • Splice.Wallet.Subscriptions
        • Templates
        • Data Types
        • Functions
    • splice-token-standard-test docs
      • Splice.Testing.Apps.TradingApp
        • Templates
        • Functions
      • Splice.Testing.Registries.AmuletRegistry
        • Data Types
        • Functions
      • Splice.Testing.Registries.AmuletRegistry.Parameters
        • Functions
      • Splice.Testing.TokenStandard.RegistryApi
        • Typeclasses
      • Splice.Testing.TokenStandard.WalletClient
        • Functions
      • Splice.Testing.Utils
        • Data Types
        • Functions
      • Splice.Tests.TestAmuletTokenDvP
        • Data Types
        • Functions
      • Splice.Tests.TestAmuletTokenTransfer
        • Data Types
        • Functions

Background

  • Architecture
    • Daml Code Architecture
      • Package Structure
      • Decentralized Transaction Validation and Automation
      • DSO Party Requirements for CC
      • CNS Party Requirements for CNS

FAQ

  • FAQ
    • Super Validators
    • Validators

Glossary

  • Glossary

Release Notes

  • Release Notes
    • 0.4.4
    • 0.4.3
    • 0.4.2
    • 0.4.1
    • 0.4.0
    • 0.3.21
    • 0.3.20
    • 0.3.19
    • 0.3.18
    • 0.3.17
    • 0.3.16
    • 0.3.15
    • 0.3.13
    • 0.3.12
    • 0.3.11
    • 0.3.10
    • 0.3.9
    • 0.3.8
    • 0.3.7
    • 0.3.6
    • 0.3.5
    • 0.3.4
    • 0.3.3
    • 0.3.2
    • 0.3.1
    • 0.3.0
      • Daml Changes in 0.3.0
    • 0.2.8
    • 0.2.7
    • 0.2.6
    • 0.2.4
    • 0.2.3
    • 0.2.1
    • 0.2.0
    • 0.1.19
    • 0.1.18
    • 0.1.17
    • 0.1.16
    • 0.1.15
    • 0.1.13
    • 0.1.12
    • 0.1.10
    • 0.1.9
    • 0.1.8
    • 0.1.7
    • 0.1.6
    • 0.1.5
    • 0.1.4
    • 0.1.3
    • 0.1.2
    • 2024-04-01
    • 2024-03-25
    • 2024-03-18
    • 2024-03-11
    • 2024-03-04
    • 2024-02-26
    • 2024-02-19
    • 2024-02-12
    • 2024-02-05
    • 2024-01-29
    • 2024-01-22
    • 2024-01-15
    • 2024-01-08
    • 2023-12-18
    • 2023-12-11
    • 2023-12-04
    • 2023-11-27
    • 2023-11-20
    • 2023-11-13
    • 2023-11-06
    • 2023-10-30
    • 2023-10-23
    • 2023-10-16
    • 2023-10-09
    • 2023-10-02
    • 2023-09-25
    • 2023-09-11
    • 2023-09-04
    • 2023-08-28
    • 2023-08-14
    • 2023-08-07
    • 2023-07-31
    • 2023-07-16
    • 2023-07-02
    • 2023-06-25
    • 2023-06-18
    • 2023-06-11
    • 2023-06-04
    • 2023-05-28
    • 2023-05-21
    • 2023-05-14
    • 2023-05-07
    • 2023-04-30
    • 2023-04-23

Community-Contributed

  • Community-Contributed Documentation
    • Okta and Keycloak OIDC Configuration Guide
      • Okta
      • Keycloak
    • Alternative Docker Compose Deployment
      • Key Features of the Solution
    • Automated Helm/Kubernetes Templating Tool
      • Key Features of the Solution
Splice
  • Splice Daml Models
  • splice-amulet docs
  • Edit on GitHub

splice-amulet docs

  • Splice.Amulet
  • Splice.Amulet.TokenApiUtils
  • Splice.Amulet.TwoStepTransfer
  • Splice.AmuletAllocation
  • Splice.AmuletConfig
  • Splice.AmuletRules
  • Splice.AmuletTransferInstruction
  • Splice.DecentralizedSynchronizer
  • Splice.Expiry
  • Splice.ExternalPartyAmuletRules
  • Splice.Fees
  • Splice.Issuance
  • Splice.RelRound
  • Splice.Round
  • Splice.Schedule
  • Splice.Types
  • Splice.ValidatorLicense

Comments

Previous Next

© Copyright 2025, Digital Asset.

Built with Sphinx using a theme provided by Read the Docs.