Minimal Bridging Stock Cordapp sample #117

szymonsztuka · 2025-09-30T12:56:17Z

The simplest bridge flow and sample to bridge a given token with Bridging Authority containing mappings to Solana accounts.
Because Confidential Identity is not used, the bridge is a move to self (owner is still Bridging Authority).
No notary change -single notary for move and brige is used.

The test uses Mock Network and issues 2 tokens and bridge one, first an participant moves token to Bridging Authority, then test calls Bridging Authority to bridge (no vault listener implemented yet), and the test asserts that token balance appears on Solana.

Temporally Bridging SDK code is here as separate modules, will be moved to platform.

…fidential identities. Bridge* flows follows the structure of similar Move flows from tokens SDK.

…-by-token-move

… transaction

…rst token to bridge instead

…lance in Corda network

…rdDapp testing

…mappings, via Cordapp config file

…t by symbol

…ridged instead of a first token within BA

shamsasari · 2025-10-06T09:58:15Z

...ing-contracts/src/main/kotlin/com/r3/corda/lib/tokens/bridging/contracts/BridgingContract.kt

+        require(instruction.programId == Token2022.PROGRAM_ID) { "Solana program id must be Token2022 program" }
+
+        require(instruction.accounts[1].pubkey == bridgingCommand.targetAddress) { "Target in instructions does not match command" }
+
+        @Suppress("MagicNumber")
+        require(instruction.data.size == 9) { "Expecting 9 bytes of instruction data" }
+
+        val instructionBytes = ByteBuffer.wrap(instruction.data.bytes).order(ByteOrder.LITTLE_ENDIAN)
+
+        val tokenInstruction = instructionBytes.get().toInt()
+
+        val amount = instructionBytes.getLong()
+        require(tokenInstruction == TokenProgramBase.MINT_TO_INSTRUCTION) { "Token instruction must be MINT_TO_INSTRUCTION" }
+
+        require(amount == lockedSum) { "Locked amount of $lockedSum must match requested mint amount $amount." }


This is brittle and hard to read. SolanaInstruction implements equals/hashCode and so you can instead compare the instruction against the expected Token2022.mintTo instruction object.

Fixed in https://github.com/corda/corda-solana-toolkit/pull/8/commits/906dc9c6ac8bb4021f883fc735501eff60ebbb68

shamsasari · 2025-10-06T10:51:46Z

...nd/bridging-flows/src/main/kotlin/com/r3/corda/lib/tokens/bridging/flows/rpc/BridgeTokens.kt

+
+@InitiatingFlow
+@StartableByRPC
+class BridgeToken(


This flow seems to be just for testing? Better suited to be just in the test class, rather than part of the CorDapp/library.

This class was removed voiding the comment.

shamsasari · 2025-10-06T15:44:20Z

...ging-flows/src/main/kotlin/com/r3/corda/lib/tokens/bridging/flows/BridgeFungibleTokenFlow.kt

+        }
+        val solanaAccountMapping = serviceHub.cordaService(SolanaAccountsMappingService::class.java)
+        val destination =
+            solanaAccountMapping.participants[singlePreviousOwner.name]!! //TODO handle null


Throw an exception if previous owner is not configured.

Fixed in https://github.com/corda/corda-solana-toolkit/pull/8/commits/35f67db4a1d804130a149599a07f392d38c5fc15

shamsasari · 2025-10-06T15:44:38Z

...ging-flows/src/main/kotlin/com/r3/corda/lib/tokens/bridging/flows/BridgeFungibleTokenFlow.kt

+        val solanaAccountMapping = serviceHub.cordaService(SolanaAccountsMappingService::class.java)
+        val destination =
+            solanaAccountMapping.participants[singlePreviousOwner.name]!! //TODO handle null
+        val mint = solanaAccountMapping.mints[cordaTokenId]!! //TODO handle null


Fixed in https://github.com/corda/corda-solana-toolkit/pull/8/commits/35f67db4a1d804130a149599a07f392d38c5fc15

shamsasari · 2025-10-06T16:35:51Z

...ging-flows/src/main/kotlin/com/r3/corda/lib/tokens/bridging/flows/BridgeFungibleTokenFlow.kt

+class BridgeFungibleTokenFlow(
+    val holder: AbstractParty,
+    val observers: List<Party> = emptyList(),
+    val token: StateAndRef<FungibleToken>, //TODO should be FungibleToken, TODO change to any TokenType would need amendments to UUID retrieval below


I think these TODOs are no longer needed?

Done, TODO is gone

shamsasari · 2025-10-09T10:21:35Z

...idging-flows/src/main/kotlin/com/r3/corda/lib/tokens/bridging/flows/BridgeTokensUtilities.kt

+fun bridgeTokens(
+    serviceHub: ServiceHub,
+    transactionBuilder: TransactionBuilder,
+    additionalOutput: List<ContractState>,


No need to add additional outputs for the user. they can do it themselves after or before calling this method.

This was slightly refactored, however the code her needs to be complete self-contained as this Token-SDK class follow Template Method Patter, and we don't have access to TransactionBuilder outside it(before the flow is run).

shamsasari · 2025-10-09T10:22:22Z

...idging-flows/src/main/kotlin/com/r3/corda/lib/tokens/bridging/flows/BridgeTokensUtilities.kt

+/**
+ * Adds a set of bridging commands to a transaction using specific outputs.
+ */
+@Suspendable


Does this really need to be suspendable?

Remove unnecessary suspendable annotation in https://github.com/corda/corda-solana-toolkit/pull/8/commits/928c5d6b8929f19d348a7bb2074a27a0647b9951

shamsasari · 2025-10-09T10:23:35Z

...idging-flows/src/main/kotlin/com/r3/corda/lib/tokens/bridging/flows/BridgeTokensUtilities.kt

+    val outputGroups: Map<IssuedTokenType, List<AbstractToken>> =
+        transactionBuilder.outputStates()
+            .map { it.data }
+            .filterIsInstance<AbstractToken>()


Should this not be FungibleToken?

The fix was already applied on other PR

shamsasari · 2025-10-09T10:28:50Z

...idging-flows/src/main/kotlin/com/r3/corda/lib/tokens/bridging/flows/BridgeTokensUtilities.kt

+        "Input and output token types must correspond to each other when moving tokensToIssue"
+    }
+
+    transactionBuilder.apply {


Can you remove this apply. it adds an extra indention for just the addCommand call.

Done in https://github.com/corda/corda-solana-toolkit/pull/8/commits/d6affc6f332fb7002b4403765c4f7f739ccb112b

shamsasari · 2025-10-09T10:33:28Z

...ging-flows/src/main/kotlin/com/r3/corda/lib/tokens/bridging/flows/BridgeFungibleTokenFlow.kt

+
+        val quantity = amount.toDecimal()
+            .toLong() //TODO this is quantity for Solana, should it be 1 to 1 what is bridged on Corda?
+        bridgeToken(


Shouldn't this utility function itself call addMoveTokens rather than assume it has been called? It makes a better utility function that correctly sets up the tx builder. Otherwise, bridgeToken is assuming the output and input states are already correctly present.

yes, this utility method no longer exists , logic in a flow call

szymonsztuka · 2025-10-29T16:23:50Z

closing, superseded by https://github.com/corda/corda-solana-toolkit/pull/8

szymonsztuka and others added 24 commits September 3, 2025 09:52

Bridging using tokens move to self without any change and without con…

cac1512

…fidential identities. Bridge* flows follows the structure of similar Move flows from tokens SDK.

Reduce formatting diff

d39ed50

Merge branch 'bridging-stock-sample' into bridging-stock-sample-brige…

1660cf6

…-by-token-move

Fix class without a package

0d422da

assert if Bridge state and token amount state are outputs of the same…

f1ff375

… transaction

Remove use of addMoveFungibleTokens from tokens, temporally select fi…

df08834

…rst token to bridge instead

Move input token selection to outer flow, code simplification

3a2a7fc

Additional Assertion on token balance (WIP)

24ef067

Additional Assertion on token balance in Solana network, and final ba…

ce6fbd2

…lance in Corda network

Update to 4.14

e73a853

Update to change from ENT-14126 SolanaTestValidator usable in user Co…

20f1a8c

…rdDapp testing

Remove println

c5afeb4

Minor changes

87238d2

remove some duplicated checks in the test, tidy up

e515d7d

Corda participant to Solana issuance address configuration and other …

236cc51

…mappings, via Cordapp config file

Addressing review comments

3550a5c

Initial refactoring before changing mapping key.

7f6676b

Use FungibleToken and LinearId for mappings (instead of stock ticket).

dec3cae

Added second token type to test and modify query inside flow to selec…

865c4c4

…t by symbol

Test util method refactoring

e8a3b2d

Tidy up

8edc2da

Added Bridging Authority to the test, WIP to get the moved token to b…

6495c56

…ridged instead of a first token within BA

Refactor SDk to own module and cordapps

ff11d9c

Refactor SDk to own module and cordapps

c9f3089

szymonsztuka changed the title ~~Bridging stock sample first cut~~ Minimal Bridging Stock Cordapp sample Sep 30, 2025

This was referenced Sep 30, 2025

Bridging via token move to self #112

Closed

Corda to Solana mappings in CordappConfig #114

Closed

Bridging Authority in the test #116

Closed

szymonsztuka requested review from mkitR3 and shamsasari September 30, 2025 14:26

Refactoring and mapping participant

7b48a18

szymonsztuka marked this pull request as ready for review September 30, 2025 15:00

szymonsztuka requested a review from blsemo September 30, 2025 15:03

szymonsztuka added 3 commits September 30, 2025 16:17

Remove import

6d67922

Filtering a single previous owner of a token in nicer way

2e4f61c

Remove Solana SDK/Common from Sample Cordapp dependencies - not used

a15e293

mkitR3 force-pushed the bridging-stock-sample-first-cut branch from 0a08b83 to a15e293 Compare October 2, 2025 14:56

shamsasari reviewed Oct 9, 2025

View reviewed changes

szymonsztuka closed this Oct 29, 2025

Minimal Bridging Stock Cordapp sample #117

Minimal Bridging Stock Cordapp sample #117

Uh oh!

Conversation

szymonsztuka commented Sep 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

szymonsztuka commented Oct 29, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

szymonsztuka commented Sep 30, 2025 •

edited

Loading