feat: multi sync example

.github/actions/setup_localnet/artifacts/action.yml

@@ -7,6 +7,10 @@ inputs:
     splice_version:
         description: 'Splice version (required)'
         required: true
+    multi_sync:
+        description: 'Enable multi-sync profile (default: true)'
+        required: false
+        default: 'true'
 runs:
     using: 'composite'
     steps:
@@ -31,4 +35,4 @@ runs:
 
         - name: Start Localnet
           shell: bash
-          run: yarn start:localnet -- --network=${{ inputs.network }}
+          run: yarn start:localnet -- --network=${{ inputs.network }} ${{ inputs.multi_sync == 'false' && '--no-multi-sync' || '' }}

.github/workflows/build.yml

@@ -389,6 +389,7 @@ jobs:
               with:
                   network: ${{ matrix.network }}
                   splice_version: ${{ matrix.network == 'devnet' && needs.version-config.outputs.devnet_splice_version || needs.version-config.outputs.mainnet_splice_version }}
+                  multi_sync: 'true'
 
             - name: Start remote WK
               run: yarn pm2 start ecosystem.ci.config.js --env development
@@ -450,6 +451,7 @@ jobs:
               with:
                   network: ${{ matrix.network }}
                   splice_version: ${{ matrix.network == 'devnet' && needs.version-config.outputs.devnet_splice_version || needs.version-config.outputs.mainnet_splice_version }}
+                  multi_sync: 'true'
 
             - uses: ./.github/actions/check_resources
 
@@ -500,6 +502,21 @@ jobs:
               with:
                   network: ${{ matrix.network }}
                   splice_version: ${{ matrix.network == 'devnet' && needs.version-config.outputs.devnet_splice_version || needs.version-config.outputs.mainnet_splice_version }}
+                  multi_sync: 'true'
+
+            - name: Restore DPM cache
+              uses: actions/cache/restore@v5
+              with:
+                  path: |
+                      ~/.dpm
+                  key: dpm-${{ runner.os }}-${{ needs.version-config.outputs.daml_release_version }}
+
+            - name: Generate featured DARs
+              run: yarn script:generate:featured-dars
+
+            - name: Rebuild DAML-dependent packages
+              run: |
+                  yarn workspace @canton-network/core-test-token build
 
             - uses: ./.github/actions/check_resources
 

.github/workflows/stress-tests.yml

@@ -65,7 +65,6 @@ jobs:
               run: yarn script:test:stress-scripts
 
             - uses: ./.github/actions/check_resources
-
             - name: Stop localnet (${{ github.event.inputs.network || 'devnet' }})
               if: always()
               run: yarn stop:localnet -- --network=${{ github.event.inputs.network || 'devnet' }}

core/amulet-service/src/index.ts

@@ -1,4 +1,5 @@
 // Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.
 // SPDX-License-Identifier: Apache-2.0
 
+export * from './interface-ids.const.js'
 export * from './amulet-service.js'

core/amulet-service/src/interface-ids.const.ts

@@ -0,0 +1,4 @@
+// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+export const AMULET_TEMPLATE_ID = '#splice-amulet:Splice.Amulet:Amulet'

core/ledger-client/src/ledger-client.ts

@@ -505,20 +505,31 @@ export class LedgerClient {
         return this.valueOrError(resp)
     }
 
-    // Retrieve an (arbitrary) synchronizer id from the validator.
+    // Retrieve the default synchronizer id from the validator.
+    // Prefers a synchronizer aliased 'global' or 'global-domain' over application-specific ones.
     // This synchronizer id is cached for the remainder of this object's life.
     public async getSynchronizerId(): Promise<string> {
         if (this.synchronizerId) return this.synchronizerId
         const response = await this.getWithRetry(
             '/v2/state/connected-synchronizers'
         )
-        if (!response.connectedSynchronizers?.[0]) {
+        const synchronizers = response.connectedSynchronizers
+        if (!synchronizers?.[0]) {
             throw new Error('No connected synchronizers found')
         }
-        const synchronizerId = response.connectedSynchronizers[0].synchronizerId
-        if (response.connectedSynchronizers.length > 1) {
+        const defaultEntry =
+            synchronizers.find((s) => s.synchronizerAlias === 'global') ??
+            synchronizers.find(
+                (s) => s.synchronizerAlias === 'global-domain'
+            ) ??
+            synchronizers.find(
+                (s) => s.synchronizerAlias !== 'app-synchronizer'
+            ) ??
+            synchronizers[0]
+        const synchronizerId = defaultEntry.synchronizerId
+        if (synchronizers.length > 1) {
             this.logger.warn(
-                `Found ${response.connectedSynchronizers.length} synchronizers, defaulting to ${synchronizerId}`
+                `Found ${synchronizers.length} synchronizers, defaulting to ${synchronizerId}`
             )
         }
         this.synchronizerId = synchronizerId

core/test-token/.gitignore

@@ -0,0 +1 @@
+.rollup.cache

core/test-token/package.json

@@ -0,0 +1,51 @@
+{
+    "name": "@canton-network/core-test-token",
+    "version": "0.0.1",
+    "type": "module",
+    "description": "DAML codegen JS for splice-test-token-v1",
+    "license": "Apache-2.0",
+    "packageManager": "yarn@4.9.4",
+    "main": "dist/index.cjs",
+    "module": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "browser": "./dist/index.browser.js",
+            "import": "./dist/index.js",
+            "require": "./dist/index.cjs",
+            "default": "./dist/index.js"
+        }
+    },
+    "scripts": {
+        "build": "yarn clean && rollup -c && yarn clean:types-tmp",
+        "clean:types-tmp": "rm -rf dist/types",
+        "clean": "rm -rf dist"
+    },
+    "dependencies": {
+        "@daml/types": "^3.5.0",
+        "@mojotech/json-type-validation": "^3.1.0"
+    },
+    "devDependencies": {
+        "@rollup/plugin-alias": "^5.0.0",
+        "@rollup/plugin-commonjs": "^29.0.0",
+        "@rollup/plugin-json": "^6.1.0",
+        "@rollup/plugin-node-resolve": "^16.0.3",
+        "@rollup/plugin-typescript": "^12.3.0",
+        "rollup": "^4.59.0",
+        "rollup-plugin-dts": "^6.3.0",
+        "tslib": "^2.8.1",
+        "typescript": "^5.9.3"
+    },
+    "files": [
+        "dist/**"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/canton-network/wallet.git",
+        "directory": "core/test-token"
+    }
+}

core/test-token/rollup.config.js

@@ -0,0 +1,150 @@
+// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+import typescript from '@rollup/plugin-typescript'
+import commonjs from '@rollup/plugin-commonjs'
+import { nodeResolve } from '@rollup/plugin-node-resolve'
+import json from '@rollup/plugin-json'
+import alias from '@rollup/plugin-alias'
+
+import fs from 'node:fs'
+import path from 'node:path'
+import dts from 'rollup-plugin-dts'
+
+const DAML_JS_BASE = path.resolve(
+    import.meta.dirname,
+    '../../damljs/splice-test-token-v1'
+)
+
+/** Auto-discover every @daml.js/* package present in baseDir. */
+function discoverDamlJsPackages(baseDir) {
+    const packages = {}
+    for (const entry of fs.readdirSync(baseDir, { withFileTypes: true })) {
+        if (!entry.isDirectory()) continue
+        const pkgJsonPath = path.join(baseDir, entry.name, 'package.json')
+        if (!fs.existsSync(pkgJsonPath)) continue
+        const pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8'))
+        if (pkgJson.name?.startsWith('@daml.js/')) {
+            packages[pkgJson.name] = path.join(baseDir, entry.name)
+        }
+    }
+    return packages
+}
+
+function buildPathsMap(packageDirs) {
+    const map = {}
+    for (const [name, pkgDir] of Object.entries(packageDirs)) {
+        const pkgJson = JSON.parse(
+            fs.readFileSync(path.join(pkgDir, 'package.json'), 'utf8')
+        )
+        const typesRel = pkgJson.types || pkgJson.typings || 'lib/index.d.ts'
+        const typesAbs = path.resolve(pkgDir, typesRel)
+        const libDir = path.resolve(pkgDir, 'lib')
+        map[name] = [typesAbs]
+        map[`${name}/*`] = [path.join(libDir, '*')]
+        map[`${name}/lib/*/module.js`] = [path.join(libDir, '*/module.d.ts')]
+        map[`${name}/lib/*/index.js`] = [path.join(libDir, '*/index.d.ts')]
+    }
+    return map
+}
+
+function buildAliasEntries(packageDirs) {
+    const entries = []
+    for (const [name, pkgDir] of Object.entries(packageDirs)) {
+        const pkgJson = JSON.parse(
+            fs.readFileSync(path.join(pkgDir, 'package.json'), 'utf8')
+        )
+        const mainAbs = path.resolve(pkgDir, pkgJson.main || 'lib/index.js')
+        const escapedName = name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+        entries.push({
+            find: new RegExp(`^${escapedName}/(.+)$`),
+            replacement: `${pkgDir}/$1`,
+        })
+        entries.push({ find: name, replacement: mainAbs })
+    }
+    return entries
+}
+
+const DAML_JS_PACKAGES = discoverDamlJsPackages(DAML_JS_BASE)
+const pathsMap = buildPathsMap(DAML_JS_PACKAGES)
+const damlJsAlias = alias({ entries: buildAliasEntries(DAML_JS_PACKAGES) })
+const commonjsPlugin = commonjs({
+    transformMixedEsModules: true,
+    esmExternals: true,
+    requireReturnsDefault: false,
+})
+
+const pkgPath = path.resolve(process.cwd(), 'package.json')
+const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'))
+
+const exceptions = [
+    '@daml/types',
+    '@daml/ledger',
+    '@mojotech/json-type-validation',
+]
+const external = [
+    ...Object.keys(pkg.dependencies || {}),
+    ...Object.keys(pkg.peerDependencies || {}),
+].filter((dep) => !exceptions.includes(dep))
+
+// bundle ESM
+const codeEsm = {
+    input: 'src/index.ts',
+    output: { file: 'dist/index.js', format: 'es', sourcemap: true },
+    external,
+    plugins: [damlJsAlias, json(), commonjsPlugin, nodeResolve(), typescript()],
+}
+
+// bundle CJS
+const codeCjs = {
+    input: 'src/index.ts',
+    output: {
+        file: 'dist/index.cjs',
+        format: 'cjs',
+        interop: 'auto',
+        sourcemap: true,
+        exports: 'named',
+    },
+    external,
+    plugins: [damlJsAlias, json(), commonjsPlugin, nodeResolve(), typescript()],
+}
+
+// bundle for browser
+const codeBrowser = {
+    input: 'src/index.ts',
+    output: {
+        file: 'dist/index.browser.js',
+        format: 'es',
+        sourcemap: true,
+    },
+    external,
+    plugins: [
+        damlJsAlias,
+        json(),
+        commonjsPlugin,
+        nodeResolve({
+            browser: true,
+            preferBuiltins: false,
+        }),
+        typescript(),
+    ],
+}
+
+// bundle DTS including types from codegen
+const types = {
+    input: 'src/index.ts',
+    output: { file: 'dist/index.d.ts', format: 'es' },
+    plugins: [
+        dts({
+            respectExternal: false,
+            compilerOptions: {
+                baseUrl: '.',
+                paths: pathsMap,
+                declaration: true,
+                emitDeclarationOnly: true,
+            },
+        }),
+    ],
+}
+
+export default [codeEsm, codeCjs, codeBrowser, types]