Skip to content

fix: shield asset-lock funding from all funds accounts incl. CoinJoin (#4073)#4184

Open
bfoss765 wants to merge 10 commits into
dashpay:v4.1-devfrom
bfoss765:port/v4.1/assetlock-multi-account
Open

fix: shield asset-lock funding from all funds accounts incl. CoinJoin (#4073)#4184
bfoss765 wants to merge 10 commits into
dashpay:v4.1-devfrom
bfoss765:port/v4.1/assetlock-multi-account

Conversation

@bfoss765

@bfoss765 bfoss765 commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Shields asset-lock funding from all funds accounts: a multi-account funding builder (build_asset_lock_tx_from_all_funding_accounts) that unions spendable UTXOs across BIP44 + CoinJoin + DashPay funds accounts with LargestFirst coin selection, excludes watch-only DashpayExternalAccount UTXOs (a contact's coins the local mnemonic cannot sign), and maps NoUtxosAvailable to the typed asset-lock insufficient-funds error, with regression tests for the router-fix persistence path and the watch-only exclusion.

Re-opens #4074 which was auto-closed when the #3999 base branch was deleted; rebased onto v4.1-dev. The PR's own rust-dashcore router customization stays dropped — v4.1-dev's rust-dashcore pin already carries that fix upstream (rust-dashcore#867), which the ported regression tests confirm against the pin. The platform-side changes in rs-platform-wallet are NOT in v4.1-dev and are all retained; the only conflict was a trivial import union in test_support.rs.

Verified: cargo test -p platform-wallet — 502 tests pass (38 asset-lock).

🤖 Generated with Claude Code


Review-response summary (2026-07-21)

  • FFI error arm: AssetLockInsufficientFunds now crosses as dedicated code 29 (ErrorAssetLockInsufficientFunds), mapped in Kotlin and Swift, with an FFI-level test pinning the numeric code and verbatim message. The Display text is unchanged from what dash-wallet already matches, so no host breakage; hosts should migrate from substring-matching to the typed code at their convenience. Codes 26–28 are deliberately skipped — they're allocated by the reservation-token errors on the split-build-broadcast branch (feat(kotlin-sdk): split build/broadcast with reservation release for BIP70-style deferred submission #4185); a comment in the enum documents the reservation so the two PRs can't collide.
  • Privacy-domain gate: selection now defaults to a single privacy domain (transparent BIP44/BIP32 — the only domain that can supply change without linking, since key-wallet derives change on Standard accounts only). Cross-domain union requires an explicit consent parameter threaded from the builder through the FFI (allow_cross_domain, default false everywhere, including the resume path); refusal is typed code 30 (ErrorAssetLockCrossDomainConsentRequired) carrying transparent/union/required amounts. The identity-funding carve-out is unchanged — consent is ignored there, pinned by test. Round-2 addition: a fee-band shortfall (transparent covers the amount but not amount+fee, union covers it) is reclassified to consent-required at the selection-failure site, so hosts prompt instead of dead-ending; both the fee-band and denied-both-short paths are now tested.
  • Reservation-ledger blocker: agreed this belongs upstream in key-wallet — a concrete design for atomic per-owning-account reservation commits (API shape, rollback semantics, platform adoption path) is drafted and will be proposed against rust-dashcore; the platform-side race window remains documented in code until that lands.
  • CI: fork PRs skip the Rust suite and we can't push same-repo refs. Local evidence a maintainer can compare: cargo test -p platform-wallet --lib → 506 passed; --features shielded --lib → 636 passed; -p platform-wallet-ffi --lib → 198 passed; clippy clean on all three crates.
  • Host coordination note: shielding CoinJoin/DashPay funds now requires allowCrossDomain = true after explicit user opt-in; dash-wallet will need a consent touchpoint before adopting the next AAR.

Summary by CodeRabbit

  • New Features

    • Added an optional funding-path setting for shielded asset-lock funding in the Kotlin and Swift SDKs.
    • Users can select a specific account’s UTXOs to fund an asset lock; leaving it blank preserves the default funding behavior.
    • Added an optional funding-account field to the Swift example app.
  • Bug Fixes

    • Asset-lock insufficient-funds errors now return a dedicated, actionable error across supported SDKs instead of a generic failure.

Provenance (tracker refs moved from code comments per review)

The build.rs funding-eligibility comments previously carried an internal review-tracking token finding 5b52d9844055 (4 sites). Removed from the comments (rationale text kept); it tracked the watch-only DashpayExternalAccount ownership carve-out now expressed through the privacy-domain map.

C-ABI note

platform_wallet_manager_shielded_fund_from_asset_lock gained a trailing allow_cross_domain: bool parameter — a C-ABI break — and result codes 29/30 (ErrorAssetLockInsufficientFunds / ErrorAssetLockCrossDomainConsentRequired) are added. See packages/rs-platform-wallet-ffi/README.md.

@coderabbitai

coderabbitai Bot commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@bfoss765, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 58 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: a158e6b5-70e9-4d7f-ae26-ca9da04dc4a3

📥 Commits

Reviewing files that changed from the base of the PR and between dfc670d and bfb1f49.

📒 Files selected for processing (21)
  • packages/kotlin-sdk/sdk/src/main/kotlin/org/dashfoundation/dashsdk/errors/DashSdkError.kt
  • packages/kotlin-sdk/sdk/src/main/kotlin/org/dashfoundation/dashsdk/ffi/FundingNative.kt
  • packages/kotlin-sdk/sdk/src/main/kotlin/org/dashfoundation/dashsdk/wallet/PlatformWalletManager.kt
  • packages/kotlin-sdk/sdk/src/test/kotlin/org/dashfoundation/dashsdk/errors/DashSdkErrorTest.kt
  • packages/rs-platform-wallet-ffi/README.md
  • packages/rs-platform-wallet-ffi/src/asset_lock/build.rs
  • packages/rs-platform-wallet-ffi/src/error.rs
  • packages/rs-platform-wallet-ffi/src/shielded_send.rs
  • packages/rs-platform-wallet/src/error.rs
  • packages/rs-platform-wallet/src/test_support.rs
  • packages/rs-platform-wallet/src/wallet/asset_lock/build.rs
  • packages/rs-platform-wallet/src/wallet/asset_lock/orchestration.rs
  • packages/rs-platform-wallet/src/wallet/asset_lock/sync/recovery.rs
  • packages/rs-platform-wallet/src/wallet/identity/network/invitation.rs
  • packages/rs-platform-wallet/src/wallet/identity/network/registration.rs
  • packages/rs-platform-wallet/src/wallet/platform_addresses/fund_from_asset_lock.rs
  • packages/rs-platform-wallet/src/wallet/shielded/fund_from_asset_lock.rs
  • packages/rs-platform-wallet/src/wallet/shielded/seed_pool.rs
  • packages/rs-unified-sdk-jni/src/funding.rs
  • packages/swift-sdk/Sources/SwiftDashSDK/PlatformWallet/PlatformWalletManagerShieldedFunding.swift
  • packages/swift-sdk/Sources/SwiftDashSDK/PlatformWallet/PlatformWalletResult.swift
📝 Walkthrough

Walkthrough

Shielded asset-lock funding now supports an optional BIP32 funding path that restricts UTXO selection to one account. Typed insufficient-funds errors are propagated through wallet, FFI, JNI, Kotlin, and Swift APIs, with Swift example-app input support.

Changes

Asset-lock funding path

Layer / File(s) Summary
Single-account asset-lock construction
packages/rs-platform-wallet/src/wallet/asset_lock/build.rs, packages/rs-platform-wallet/src/test_support.rs
Shielded asset-lock builds select one signable account, use LargestFirst, exclude watch-only DashPay accounts, and map selection shortfalls to typed errors with expanded fixtures and regression tests.
Funding-path orchestration
packages/rs-platform-wallet/src/wallet/asset_lock/..., packages/rs-platform-wallet/src/wallet/shielded/..., packages/rs-platform-wallet/src/wallet/identity/...
The optional derivation path is threaded through fresh shielded funding and asset-lock proof construction; non-shielded and resume flows pass None.
FFI parameter and error propagation
packages/rs-platform-wallet-ffi/src/..., packages/rs-platform-wallet/src/error.rs
The native bridge parses optional UTF-8 derivation paths and maps asset-lock insufficient funds to result code 29 while preserving error messages.
Kotlin and Swift SDK integration
packages/kotlin-sdk/..., packages/rs-unified-sdk-jni/..., packages/swift-sdk/...
Public SDK methods accept funding paths, native bridges marshal them, and Kotlin and Swift decode the dedicated insufficient-funds error; the Swift example app adds a Core funding-path field.

Estimated code review effort: 4 (Complex) | ~60 minutes

Possibly related issues

Possibly related PRs

  • dashpay/platform#3671 — Shares the asset-lock funding-resolution orchestration extended here.
  • dashpay/platform#3753 — Shares the shielded-from-asset-lock pipeline extended with funding-path selection and typed errors.
  • dashpay/platform#3858 — Modifies the same shielded funding orchestration and seed-pool call paths.

Suggested reviewers: quantumexplorer, shumkov, lklimek, zocolini

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Title check ⚠️ Warning The title says funding comes from all funds accounts, but the PR actually restricts asset-lock funding to a single account or explicit derivation path. Revise the title to reflect single-account or derivation-path asset-lock funding, not cross-account union funding.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@thepastaclaw

thepastaclaw commented Jul 21, 2026

Copy link
Copy Markdown
Collaborator

🕓 Ready for review — 5 ahead in queue (commit e6da504)
Queue position: 6/24 · 2 reviews active
ETA: start ~09:07 UTC · complete ~09:28 UTC (median 21m across 30 recent reviews; 2 slots)
Queued 18h 10m ago · Last checked: 2026-07-23 08:20 UTC

@bfoss765

Copy link
Copy Markdown
Contributor Author

@coderabbitai full review

@coderabbitai

coderabbitai Bot commented Jul 21, 2026

Copy link
Copy Markdown
Contributor
✅ Action performed

Full review finished.


Your plan includes PR reviews subject to rate limits. More reviews will be available in 47 minutes.

@shumkov

shumkov commented Jul 21, 2026

Copy link
Copy Markdown
Collaborator

The fix is correct and still reproduces on tip (the #4073 symptom is live in asset_lock/build.rs on v4.1-dev); shielded-only routing with the privacy carve-out for identity funding is the right call. Two must-address items:

  • The new AssetLockInsufficientFunds never crosses the FFI: no arm in From<PlatformWalletError> (rs-platform-wallet-ffi/src/error.rs:267-337) so it flattens to ErrorUnknown(99) — the exact complaint in kotlin-sdk: shieldedFundFromAssetLock coin selection only reaches one account (CoinJoin/other-account funds unspendable) #4073 request 3. The message text also changed, which silently breaks dash-wallet's message matching. Please add an FFI code (sibling of ErrorCoreInsufficientFunds = 22) or explicitly scope the FFI mapping as a coordinated follow-up.
  • CI ran zero Rust jobs (fork PR — wallet suite, workspace shards, and lint all skipped; the green run only proves the Kotlin/Swift builds). The 38 new tests need an actual CI run — push to a same-repo ref or otherwise force the wallet suite before merge.

Minor: the SwiftExampleApp funding picker still gates on the single BIP44 account, so the UI blocks the exact scenario this fixes (follow-up); the upstream-behavior pin tests (router/gap-limit) will trip on any rust-dashcore pin change — deliberate?; tracker refs ("finding 5b52d9844055") → PR description.

@shumkov

shumkov commented Jul 21, 2026

Copy link
Copy Markdown
Collaborator

Two additional architecture blockers after checking the existing comments:

  1. Extra-account inputs are reserved in the primary account's ledger, not their owning ledgers. The code documents this limitation around build_asset_lock_tx_from_all_funding_accounts: set_funding(primary) captures one ReservationSet, then add_inputs(extras) records CoinJoin/BIP32 inputs there. Activity built through the source account can therefore reselect the same UTXO before broadcast reconciliation. The safe fix belongs upstream in key-wallet: union selection and per-source-account reservations must commit atomically.
  2. The union silently crosses privacy domains. Largest-first can combine ordinary BIP44/BIP32 funds, CoinJoin outputs, and DashPay receiving funds into one L1 transaction, with BIP44 change. That irreversibly links those domains; shielding afterward cannot undo it. Please select within one domain by default and require explicit caller/user consent before cross-domain co-spend.

The existing typed-error and Swift BIP44-only preflight comments are correct and are not duplicated here.

bfoss765 added a commit to bfoss765/platform that referenced this pull request Jul 21, 2026
…vacy-domain funding gate (dashpay#4184)

Addresses two must-fix reviewer findings on PR dashpay#4184.

1. FFI error arm for the asset-lock shortfall (dashpay#4073 request 3).
`AssetLockInsufficientFunds` never crossed the FFI: with no arm in
`From<PlatformWalletError>` it flattened to `ErrorUnknown(99)`, hiding a
typed shortfall behind the catch-all and forcing hosts to string-match the
Display text. Add:
  - `ErrorAssetLockInsufficientFunds = 26` (sibling of ErrorCoreInsufficientFunds
    = 22; existing codes unchanged), mapped in the From impl (the structured
    available/required duffs still travel in the message), plus a Rust test that
    the error crosses as code 26 (not 99) with the message verbatim.
  - Kotlin `DashSdkError.PlatformWallet.AssetLockInsufficientFunds` (26 ->) and
    Swift `.errorAssetLockInsufficientFunds`; cbindgen emits the C constant.
The Display text is UNCHANGED ("asset lock coin selection is short: ...") so
dash-wallet's existing substring matcher keeps working while it migrates to the
typed code.

2. Privacy-domain co-spend gate. Largest-first could union ordinary BIP44/BIP32,
CoinJoin, and DashPay-receiving funds into one L1 tx (with BIP44 change),
irreversibly linking those domains. Default funding now stays within a single
privacy domain:
  - Domains: Transparent {BIP44,BIP32} > CoinJoin > DashPay-receiving. Transparent
    is the only default-eligible domain because it holds the primary account and
    is the sole source of change (key-wallet derives change only on Standard
    accounts) — so any non-transparent spend inherently crosses into it.
  - New `CrossDomainConsent` (Denied default / Allowed opt-in) threaded through the
    builder, orchestration, `shielded_fund_from_asset_lock`, the JNI bridge, and the
    `platform_wallet_manager_shielded_fund_from_asset_lock` FFI (`allow_cross_domain:
    bool`). Wrapper methods keep every existing caller on the safe default.
  - Cross-domain refusal returns the typed `AssetLockCrossDomainConsentRequired`
    (FFI code 27; Kotlin/Swift mapped) carrying transparent/union/required duffs.
  - Watch-only DashpayExternalAccount exclusion preserved via the domain classifier
    (returns None); identity-funding single-BIP44 carve-out preserved.
Tests: single-domain success without consent; cross-domain refused without consent
(typed error) and succeeds with consent; existing union/CoinJoin/DashPay tests moved
to the consented path.

cargo test -p platform-wallet --lib = 504 passed; --features shielded = 634 passed;
-p platform-wallet-ffi --lib = 198 passed. clippy clean on all three crates.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@bfoss765

Copy link
Copy Markdown
Contributor Author

Both must-fix items and both architecture blockers are addressed and pushed. AssetLockInsufficientFunds crosses the FFI as dedicated code 29 (we skipped 26–28 — they're taken by #4185's reservation-token errors on the same base; the enum documents the reservation so the PRs can't silently collide on merge), message text unchanged so existing matching keeps working. Selection now defaults to a single privacy domain with an explicit allow_cross_domain consent parameter (default false at every entry point, typed code 30 on refusal, identity carve-out unchanged and pinned by test) — including a reclassification our own review round caught: a fee-band shortfall (transparent covers the amount but not amount+fee while the union covers it) now surfaces as consent-required rather than dead-ending as insufficient funds.

On the reservation-ledger blocker: implemented upstream as you specified — a rust-dashcore key-wallet PR (opening shortly) adds set_funding_multi reserving each selected input in its owning account's ledger, committed atomically post-selection with signing-failure rollback across all ledgers; platform adopts it at the next pin bump, replacing the set_funding + add_inputs composition. On CI: fork PRs skip the Rust suite — local evidence is in the PR description (506/636/198 tests, clippy clean); if you can trigger the wallet suite on a same-repo ref, even better.

@bfoss765

Copy link
Copy Markdown
Contributor Author

@coderabbitai full review

@coderabbitai

coderabbitai Bot commented Jul 21, 2026

Copy link
Copy Markdown
Contributor
✅ Action performed

Full review finished.


Your plan includes PR reviews subject to rate limits. More reviews will be available in 35 minutes.

bfoss765 added a commit to bfoss765/platform that referenced this pull request Jul 21, 2026
…the signer wire

Replace end-to-end message sniffing for the signer's "missing key" failure
with a typed discriminator (dashpay#4060 finding 7):

- rs-sdk-ffi: DashSDKSignerErrorCode { Generic = 0, SigningKeyUnavailable =
  1, AuthenticationFailed = 2 (reserved) }; SignCompletionCallback and
  dash_sdk_sign_async_completion gain error_code: i32 (before
  error_message). SignResult stays Result<Vec<u8>, ProtocolError> (a new
  rs-dpp ProtocolError variant would carry serialization blast radius), so
  code 1 rides the single Rust-owned machine prefix
  DASH_SDK_SIGNER_ERR_KEY_UNAVAILABLE_PREFIX through
  ProtocolError::Generic — typed at both ABI edges, one constant bridging
  the string segment. This is an internal coordinated ABI change: every
  piece versions together in this monorepo.
- rs-platform-wallet-ffi: PlatformWalletFFIResultCode::
  ErrorSigningKeyUnavailable = 31 (codes 26-28 are reserved for dashpay#4185's
  reservation-token errors and 29/30 for dashpay#4184's asset-lock errors on
  sibling branches — documented in the enum as dashpay#4184 does). The
  From<dpp::ProtocolError> conversion restores the typed code from the
  prefix FIRST (before the loose keyword sniffs), and the
  From<PlatformWalletError> blanket impl restores it on the catch-all only
  (dedicated retry-semantics codes are never overridden) — covering the
  Sdk(dash_sdk::Error::Protocol(..)) wrapping path.
- JNI/Kotlin: SignerNative.completeSign(token, signature, errorCode,
  errorMessage); KeystoreSigner passes SIGNER_ERROR_CODE_KEY_UNAVAILABLE on
  the null-key branch (keeping the MESSAGE_MARKER text for the transition
  window) and Generic everywhere else. DashSdkError maps 31 →
  PlatformWallet.SigningKeyUnavailable; the dashpay#4191 marker sniff on the
  catch-all codes remains as a deprecated old-native fallback with a
  removal note tied to the next minor release.
- Swift: KeychainSigner trampolines forward the code (missing-row /
  missing-scalar outcomes classify as 1); PlatformWalletResultCode gains
  errorSigningKeyUnavailable = 31 → PlatformWalletError
  .signingKeyUnavailable (Kotlin parity).
- Tests: rs-sdk-ffi completion-code tests (prefix present for code 1,
  absent for generic), platform-wallet-ffi prefix→31 tests on both
  conversion points, Kotlin code-31 + fallback-marker tests, Swift mapping
  and trampoline-classifier tests.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@shumkov

shumkov commented Jul 22, 2026

Copy link
Copy Markdown
Collaborator

Consolidated re-verification (two independent passes). The pushed substance checks out: typed codes 29/30 with by-ref mapping so the shielded entry point can't drift, Kotlin mappings + tests, the privacy-domain consent gate is thorough (transparent-vs-union precheck, fee-band reclassification, default-deny at every entry), and filing rust-dashcore#912 for the reservation ledger is the right split. The Rust asset-lock suite passes 8/8 locally. Remaining blockers:

  1. Swift does not compile. PlatformWalletResult.swift adds cases 29/30 to the result-code enum and the C-constant mapping, but PlatformWalletError has no matching cases and init(result:) switches over result.code with no default — the switch is now non-exhaustive → compile error. It's currently masked because the Swift CI job dies at the runner's keychain setup before compiling anything. Add the two error cases + mappings and get a real compile run.

  2. The multi-account reservation race is now load-bearing. Inputs selected from CoinJoin/BIP32/DashPay accounts are recorded only in the primary BIP44 ledger, so their owning account can concurrently select them — and this PR's whole purpose is to route through those accounts. rust-dashcore#912 is the right fix but hasn't landed. Either hold this until the pin bump adopts it, or get an explicit maintainer sign-off to ship with the documented race.

  3. The consent path is unreachable from SwiftExampleApp. ShieldedFundFromAssetLockView.swift still builds the funding picker from BIP44 accounts only and never sets allowCrossDomain, so the advertised all-funds/cross-domain flow cannot be exercised or consented to on iOS (KotlinExampleApp is fine). Needs a consent/retry UI path or an explicitly tracked follow-up.

  4. CI has still never run the Rust suite on any head of this PR (fork gate skips wallet tests, workspace shards, and lint). Please get this onto a same-repo ref before merge — the ~500 wallet tests and the Swift fix both need a real CI run.

Minor: the new build.rs comments add three more "finding …" tracker refs (please move to the PR description); the fund-from-asset-lock export gained a parameter — C-ABI break worth a release-note line; the upstream-pin tests (router/gap-limit) living here vs upstream still needs a maintainer decision.

bfoss765 added a commit to bfoss765/platform that referenced this pull request Jul 22, 2026
 blocker)

PlatformWalletResultCode gained cases 29/30
(errorAssetLockInsufficientFunds, errorAssetLockCrossDomainConsentRequired)
but PlatformWalletError had no matching cases, so init(result:) — which
switches over result.code with no default — became non-exhaustive and the
Swift package no longer compiled.

Add the two matching cases (assetLockInsufficientFunds,
assetLockCrossDomainConsentRequired) to PlatformWalletError, extend the
errorDescription associated-value binding, and map both codes in
init(result:). Semantics/messages mirror the Kotlin
DashSdkError.PlatformWallet counterparts (codes 29/30).

Verified: swiftc -typecheck of PlatformWalletResult.swift against a stub
DashSDKFFI module built from the cbindgen-generated header now passes;
removing the fix reproduces "switch must be exhaustive".

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
bfoss765 added a commit to bfoss765/platform that referenced this pull request Jul 22, 2026
ShieldedFundFromAssetLockView built its funding picker from BIP44 accounts
only and never set allowCrossDomain, so the all-funds/cross-domain flow
could not be exercised or consented to on iOS.

Add a minimal "Allow cross-domain funds" toggle (transparent-only by
default) wired through to shieldedFundFromAssetLock(allowCrossDomain:), so
the code-30 gate is reachable. A tracked TODO on crossDomainConsentSection
records the intended fuller UX (submit false, catch
errorAssetLockCrossDomainConsentRequired, show the transparent/union/
required breakdown, then retry with true) as a follow-up to file — the PR
is held for rust-dashcore#912 before that lands.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
bfoss765 added a commit to bfoss765/platform that referenced this pull request Jul 22, 2026
dashpay#4184)

- Remove the "finding <hash>" tracker references from build.rs comments
  (rationale text kept); these belong in the PR description, not the source.
- Add an ABI/release-note line to the platform-wallet-ffi README recording
  the C-ABI break: platform_wallet_manager_shielded_fund_from_asset_lock
  gained a trailing `bool allow_cross_domain` parameter, plus result codes
  29/30.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
bfoss765 added a commit to bfoss765/platform that referenced this pull request Jul 22, 2026
`PlatformWalletResultCode` jumped from 25 straight to 98, so the three deferred
build->broadcast/release codes this PR owns (26 StaleReservationToken, 27
ReservationTokenConsumed, 28 ReservationWalletMismatch) fell through to
`.errorUnknown` on iOS, erasing their distinct retry semantics.

Add the three raw codes to `PlatformWalletResultCode`, matching cases to
`PlatformWalletError`, and map them in both `init(ffi:)` and `init(result:)`.
The `init(result:)` switch (no default) stays exhaustive — the same
non-exhaustive-switch class shumkov flagged on dashpay#4184. Messages pass the Rust
`Display` string straight through, matching the Kotlin SDK's mapping verbatim.

Verified with `swiftc -parse` (the DashSDKFFI xcframework — cbindgen header +
cdylib — is built separately by build_ios.sh and is not present in this
checkout, so a full `swift build` type-check isn't possible here).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In
`@packages/swift-sdk/SwiftExampleApp/SwiftExampleApp/Views/ShieldedFundFromAssetLockView.swift`:
- Around line 275-302: Update the canSubmit logic in
ShieldedFundFromAssetLockView so enabling allowCrossDomain no longer requires
the selected BIP44 balance to cover the full lock amount. Permit submission when
cross-domain consent is enabled, while preserving the existing balance
validation when it is disabled and letting Rust perform the authoritative
union-funds check.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 3eef4ea0-742b-45b1-883c-1ec0700a620b

📥 Commits

Reviewing files that changed from the base of the PR and between 8b466ab and e6da504.

📒 Files selected for processing (19)
  • packages/kotlin-sdk/sdk/src/main/kotlin/org/dashfoundation/dashsdk/errors/DashSdkError.kt
  • packages/kotlin-sdk/sdk/src/main/kotlin/org/dashfoundation/dashsdk/ffi/FundingNative.kt
  • packages/kotlin-sdk/sdk/src/main/kotlin/org/dashfoundation/dashsdk/wallet/PlatformWalletManager.kt
  • packages/kotlin-sdk/sdk/src/test/kotlin/org/dashfoundation/dashsdk/errors/DashSdkErrorTest.kt
  • packages/rs-platform-wallet-ffi/README.md
  • packages/rs-platform-wallet-ffi/src/error.rs
  • packages/rs-platform-wallet-ffi/src/shielded_send.rs
  • packages/rs-platform-wallet/src/error.rs
  • packages/rs-platform-wallet/src/lib.rs
  • packages/rs-platform-wallet/src/test_support.rs
  • packages/rs-platform-wallet/src/wallet/asset_lock/build.rs
  • packages/rs-platform-wallet/src/wallet/asset_lock/mod.rs
  • packages/rs-platform-wallet/src/wallet/asset_lock/orchestration.rs
  • packages/rs-platform-wallet/src/wallet/shielded/fund_from_asset_lock.rs
  • packages/rs-platform-wallet/src/wallet/shielded/seed_pool.rs
  • packages/rs-unified-sdk-jni/src/funding.rs
  • packages/swift-sdk/Sources/SwiftDashSDK/PlatformWallet/PlatformWalletManagerShieldedFunding.swift
  • packages/swift-sdk/Sources/SwiftDashSDK/PlatformWallet/PlatformWalletResult.swift
  • packages/swift-sdk/SwiftExampleApp/SwiftExampleApp/Views/ShieldedFundFromAssetLockView.swift

@bfoss765

Copy link
Copy Markdown
Contributor Author

Addressed the independent findings; the reservation race stays held for rust-dashcore#912.

  • Swift now compiles — added the two PlatformWalletError cases for codes 29/30 and mapped them in init(result:), making the switch exhaustive (verified with swiftc -typecheck against the cbindgen-generated header — removing the arms reproduces "switch must be exhaustive").
  • Cross-domain consent — wired an "Allow cross-domain funds" toggle (default off) into ShieldedFundFromAssetLockView's fresh-build branch so the code-30 gate is reachable/consentable on iOS, plus a tracked TODO for the fuller catch-30/retry dialog.
  • Moved the build.rs tracker refs to the description; added a C-ABI release note for the trailing allow_cross_domain parameter.
  • Finding 2 (multi-account reservation race): intentionally NOT fixed here — holding this PR for rust-dashcore#912 (atomic per-owning-account ReservationSet commit), then adopting it at the pin bump.
  • CI still runs zero Rust jobs on this fork PR; local evidence: asset-lock suite 46/46 (consent group green), FFI 198/198 incl. the 29/30 mapping tests, clippy clean.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
packages/rs-platform-wallet-ffi/src/shielded_send.rs (1)

1079-1085: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Update the stale error-reference comment.

AssetLockCrossDomainConsentRequired is no longer present in PlatformWalletError / the FFI code mapping, so this comment should only cover AssetLockInsufficientFunds and drop the cross-domain consent rationale.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/rs-platform-wallet-ffi/src/shielded_send.rs` around lines 1079 -
1085, The error-preservation comment in the result handling block should no
longer reference AssetLockCrossDomainConsentRequired or cross-domain consent
behavior. Update it to document only preservation of AssetLockInsufficientFunds
as a dedicated FFI error code, while retaining the existing generic-error
distinction and message-prefix rationale.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@packages/rs-platform-wallet/src/wallet/shielded/fund_from_asset_lock.rs`:
- Line 153: Limit shielded asset-lock funding to the primary account until
reservation bookkeeping supports the selected funding_path, or carry that
account/path through every reservation and release operation in the asset-lock
build flow. Update the funding_path handling in the shielded builder and the
reservation logic in build.rs so rejected or concurrent secondary-account builds
cannot reserve, release, or reselect inputs under the primary
BIP44/account-index path.

---

Outside diff comments:
In `@packages/rs-platform-wallet-ffi/src/shielded_send.rs`:
- Around line 1079-1085: The error-preservation comment in the result handling
block should no longer reference AssetLockCrossDomainConsentRequired or
cross-domain consent behavior. Update it to document only preservation of
AssetLockInsufficientFunds as a dedicated FFI error code, while retaining the
existing generic-error distinction and message-prefix rationale.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 850ec629-a6b8-4066-93fd-aafdb3f1dd72

📥 Commits

Reviewing files that changed from the base of the PR and between e6da504 and dfc670d.

📒 Files selected for processing (19)
  • packages/kotlin-sdk/sdk/src/main/kotlin/org/dashfoundation/dashsdk/errors/DashSdkError.kt
  • packages/kotlin-sdk/sdk/src/main/kotlin/org/dashfoundation/dashsdk/ffi/FundingNative.kt
  • packages/kotlin-sdk/sdk/src/main/kotlin/org/dashfoundation/dashsdk/wallet/PlatformWalletManager.kt
  • packages/rs-platform-wallet-ffi/src/asset_lock/build.rs
  • packages/rs-platform-wallet-ffi/src/error.rs
  • packages/rs-platform-wallet-ffi/src/shielded_send.rs
  • packages/rs-platform-wallet/src/error.rs
  • packages/rs-platform-wallet/src/wallet/asset_lock/build.rs
  • packages/rs-platform-wallet/src/wallet/asset_lock/orchestration.rs
  • packages/rs-platform-wallet/src/wallet/asset_lock/sync/recovery.rs
  • packages/rs-platform-wallet/src/wallet/identity/network/invitation.rs
  • packages/rs-platform-wallet/src/wallet/identity/network/registration.rs
  • packages/rs-platform-wallet/src/wallet/platform_addresses/fund_from_asset_lock.rs
  • packages/rs-platform-wallet/src/wallet/shielded/fund_from_asset_lock.rs
  • packages/rs-platform-wallet/src/wallet/shielded/seed_pool.rs
  • packages/rs-unified-sdk-jni/src/funding.rs
  • packages/swift-sdk/Sources/SwiftDashSDK/PlatformWallet/PlatformWalletManagerShieldedFunding.swift
  • packages/swift-sdk/Sources/SwiftDashSDK/PlatformWallet/PlatformWalletResult.swift
  • packages/swift-sdk/SwiftExampleApp/SwiftExampleApp/Views/ShieldedFundFromAssetLockView.swift
💤 Files with no reviewable changes (3)
  • packages/swift-sdk/Sources/SwiftDashSDK/PlatformWallet/PlatformWalletResult.swift
  • packages/kotlin-sdk/sdk/src/main/kotlin/org/dashfoundation/dashsdk/errors/DashSdkError.kt
  • packages/rs-platform-wallet-ffi/src/error.rs

dummy_outputs: usize,
settings: Option<PutSettings>,
cl_wait: Option<Duration>,
funding_path: Option<::key_wallet::bip32::DerivationPath>,

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🗄️ Data Integrity & Integration | 🟠 Major | 🏗️ Heavy lift

Scope reservations to the selected funding account.

funding_path now allows shielded asset-lock builds to consume CoinJoin/DashPay UTXOs, but packages/rs-platform-wallet/src/wallet/asset_lock/build.rs still records and releases reservations through the primary BIP44/account-index path. A rejected or concurrent secondary-account build can therefore leave inputs reserved incorrectly—or selectable again—causing false shortfalls or duplicate input selection on retry. Carry the owning account/path through reservation bookkeeping and make release atomic, or gate explicit secondary-account funding until the upstream fix is adopted.

Based on the PR objectives, this reservation race is explicitly still unresolved and tracked for an upstream atomic-reservation fix.

Also applies to: 222-227

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/rs-platform-wallet/src/wallet/shielded/fund_from_asset_lock.rs` at
line 153, Limit shielded asset-lock funding to the primary account until
reservation bookkeeping supports the selected funding_path, or carry that
account/path through every reservation and release operation in the asset-lock
build flow. Update the funding_path handling in the shielded builder and the
reservation logic in build.rs so rejected or concurrent secondary-account builds
cannot reserve, release, or reselect inputs under the primary
BIP44/account-index path.

bfoss765 and others added 2 commits July 22, 2026 20:39
… on base's upstreamed router fix (dashpay#4074)

Rebase of PR dashpay#4074 (fix/kotlin-sdk-assetlock-multi-account) onto
feat/kotlin-sdk-and-example-app. The platform-wallet asset-lock changes are
preserved; the PR's OWN rust-dashcore customization is dropped because the
base branch now carries the same fix upstream.

What this brings to the asset-lock code path (packages/rs-platform-wallet):
- Multi-account funding builder `build_asset_lock_tx_from_all_funding_accounts`
  that unions spendable UTXOs across BIP44 + CoinJoin + DashPay funds accounts
  (dashpay#4073), with LargestFirst coin selection pinned for the
  many-small-denomination CoinJoin shape.
- Exclusion of watch-only `DashpayExternalAccount` UTXOs from the union — those
  are a contact's coins the local mnemonic can't sign; selecting one yields an
  invalid input signature. The receiving (ours) DashPay account stays included.
- `NoUtxosAvailable` mapped to the typed asset-lock insufficient-funds error.
- Regression tests covering the router-fix persistence path (CoinJoin +
  DashpayReceivingFunds legs) and the watch-only exclusion, plus split-funded
  test fixtures (`split_funded_wallet_manager`, `..._dashpay`,
  `..._many_coinjoin`).

Why the PR's rust-dashcore vendoring/[patch] is DROPPED:
The PR originally shipped the asset-lock transaction-router fix by pinning
rust-dashcore at 1860089e and redirecting it via a `[patch]` to a bfoss765
fork (rev e8c7335 = 1860089e + the router fix + a CoinJoin gap-limit 30->100
bump). The base branch's rust-dashcore rev 19690d31 now contains BOTH fixes
upstream:
  * `TransactionRouter::get_relevant_account_types(AssetLock)` includes
    CoinJoin, DashpayReceivingFunds, and DashpayExternalAccount (via
    `fund_bearing_account_types()`);
  * `DEFAULT_COINJOIN_GAP_LIMIT = 100`.
So the fork [patch], the pinned 1860089e rev, and the leftover
`third_party/rust-dashcore` are all obsolete and removed. Cargo.toml/Cargo.lock
are taken as-is from base (rust-dashcore resolves from dashpay @ 19690d31, no
patch table). Because base's fix debits CoinJoin/DashPay asset-lock spends via
the normal `check_core_transaction` scan, the PR's earlier broadcast-time
`debit_router_omitted_asset_lock_spends` mitigation is gone — as it already was
in the PR's final state (dashpay/dash-wallet#1507).

History note: the PR's 10 original commits touched the same four files the base
branch had independently rewritten (+928 lines), and included add-then-remove
churn (the interim mitigation) plus vendor-then-git-patch churn that base's
upstreamed fix makes moot. They are collapsed into this single commit to keep
the rebased history coherent. Verified: `cargo check -p platform-wallet
--all-targets`, `-p rs-unified-sdk-jni`, `-p platform-wallet-ffi` all green;
`cargo test -p platform-wallet --lib` = 502 passed / 0 failed, including the
router-fix and watch-only-exclusion regression tests, against base's 19690d31.

Original commits folded in: 9be2e14, 5376235, e1593f4, da97eec
(app-code only; vendoring dropped), ce482fd (app-code only; vendored
gap-limit dropped), 380645a, b43caed (dropped: pure [patch] plumbing),
a5ea9e5, 77561d2, 189e068.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…vacy-domain funding gate (dashpay#4184)

Addresses two must-fix reviewer findings on PR dashpay#4184.

1. FFI error arm for the asset-lock shortfall (dashpay#4073 request 3).
`AssetLockInsufficientFunds` never crossed the FFI: with no arm in
`From<PlatformWalletError>` it flattened to `ErrorUnknown(99)`, hiding a
typed shortfall behind the catch-all and forcing hosts to string-match the
Display text. Add:
  - `ErrorAssetLockInsufficientFunds = 26` (sibling of ErrorCoreInsufficientFunds
    = 22; existing codes unchanged), mapped in the From impl (the structured
    available/required duffs still travel in the message), plus a Rust test that
    the error crosses as code 26 (not 99) with the message verbatim.
  - Kotlin `DashSdkError.PlatformWallet.AssetLockInsufficientFunds` (26 ->) and
    Swift `.errorAssetLockInsufficientFunds`; cbindgen emits the C constant.
The Display text is UNCHANGED ("asset lock coin selection is short: ...") so
dash-wallet's existing substring matcher keeps working while it migrates to the
typed code.

2. Privacy-domain co-spend gate. Largest-first could union ordinary BIP44/BIP32,
CoinJoin, and DashPay-receiving funds into one L1 tx (with BIP44 change),
irreversibly linking those domains. Default funding now stays within a single
privacy domain:
  - Domains: Transparent {BIP44,BIP32} > CoinJoin > DashPay-receiving. Transparent
    is the only default-eligible domain because it holds the primary account and
    is the sole source of change (key-wallet derives change only on Standard
    accounts) — so any non-transparent spend inherently crosses into it.
  - New `CrossDomainConsent` (Denied default / Allowed opt-in) threaded through the
    builder, orchestration, `shielded_fund_from_asset_lock`, the JNI bridge, and the
    `platform_wallet_manager_shielded_fund_from_asset_lock` FFI (`allow_cross_domain:
    bool`). Wrapper methods keep every existing caller on the safe default.
  - Cross-domain refusal returns the typed `AssetLockCrossDomainConsentRequired`
    (FFI code 27; Kotlin/Swift mapped) carrying transparent/union/required duffs.
  - Watch-only DashpayExternalAccount exclusion preserved via the domain classifier
    (returns None); identity-funding single-BIP44 carve-out preserved.
Tests: single-domain success without consent; cross-domain refused without consent
(typed error) and succeeds with consent; existing union/CoinJoin/DashPay tests moved
to the consented path.

cargo test -p platform-wallet --lib = 504 passed; --features shielded = 634 passed;
-p platform-wallet-ffi --lib = 198 passed. clippy clean on all three crates.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
bfoss765 and others added 8 commits July 22, 2026 20:47
Cross-PR collision: the split-build-broadcast branch (dashpay#4185) already
allocates 26-28 for the reservation-token errors on the same base, and
both PRs would merge without textual conflict, silently misclassifying
errors on whichever lands second. Codes 26-28 are now documented as
reserved for dashpay#4185.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Review round 2: the pre-selection consent gate compares fee-exclusive
totals, so a transparent balance in [target, target+fee) passed the gate
and then died in selection as plain insufficient-funds — the host never
learned that consent would unlock the spend. The selection-failure
mapping now converts the shortfall to AssetLockCrossDomainConsentRequired
when consent is denied and the union covers what selection reported
missing. Adds the fee-band test and the denied-both-short test the
review found uncovered.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 blocker)

PlatformWalletResultCode gained cases 29/30
(errorAssetLockInsufficientFunds, errorAssetLockCrossDomainConsentRequired)
but PlatformWalletError had no matching cases, so init(result:) — which
switches over result.code with no default — became non-exhaustive and the
Swift package no longer compiled.

Add the two matching cases (assetLockInsufficientFunds,
assetLockCrossDomainConsentRequired) to PlatformWalletError, extend the
errorDescription associated-value binding, and map both codes in
init(result:). Semantics/messages mirror the Kotlin
DashSdkError.PlatformWallet counterparts (codes 29/30).

Verified: swiftc -typecheck of PlatformWalletResult.swift against a stub
DashSDKFFI module built from the cbindgen-generated header now passes;
removing the fix reproduces "switch must be exhaustive".

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
ShieldedFundFromAssetLockView built its funding picker from BIP44 accounts
only and never set allowCrossDomain, so the all-funds/cross-domain flow
could not be exercised or consented to on iOS.

Add a minimal "Allow cross-domain funds" toggle (transparent-only by
default) wired through to shieldedFundFromAssetLock(allowCrossDomain:), so
the code-30 gate is reachable. A tracked TODO on crossDomainConsentSection
records the intended fuller UX (submit false, catch
errorAssetLockCrossDomainConsentRequired, show the transparent/union/
required breakdown, then retry with true) as a follow-up to file — the PR
is held for rust-dashcore#912 before that lands.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
dashpay#4184)

- Remove the "finding <hash>" tracker references from build.rs comments
  (rationale text kept); these belong in the PR description, not the source.
- Add an ABI/release-note line to the platform-wallet-ffi README recording
  the C-ABI break: platform_wallet_manager_shielded_fund_from_asset_lock
  gained a trailing `bool allow_cross_domain` parameter, plus result codes
  29/30.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…optional derivation path (drop multi-account union + consent gate)

Replace the multi-account union + privacy-domain consent gate with a single
account-by-derivation-path selection. The caller either accepts the default
(unmixed BIP44 account) or passes one explicit BIP32 path (e.g. the DIP-9
CoinJoin account) as a nullable String, threaded Kotlin -> JNI -> FFI -> Rust
as Option<DerivationPath>. No union across accounts, no consent prompt.

- rs-platform-wallet: drop build_asset_lock_tx_from_all_funding_accounts,
  CrossDomainConsent/PrivacyDomain, and AssetLockCrossDomainConsentRequired;
  add build_asset_lock_tx_from_selected_account (single account by path, change
  routed to the BIP44 account since non-Standard accounts cannot derive change);
  collapse the four *_with_consent wrapper pairs into a single funding_path arg.
- rs-platform-wallet-ffi: swap allow_cross_domain bool for funding_path
  (ptr+len UTF-8 BIP32 string); drop error code 30.
- rs-unified-sdk-jni / kotlin-sdk: allowCrossDomain: Boolean -> fundingPath:
  String?; drop DashSdkError.PlatformWallet.AssetLockCrossDomainConsentRequired.
- Replace the union/consent tests with single-path tests (explicit CoinJoin
  path, default BIP44, no-union proof, typed shortfall, watch-only refusal).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…g path (drop cross-domain consent + code 30)

Mirror the Kotlin re-scope (2d86a29) on the second consumer of the
same C ABI. The FFI dropped the allow_cross_domain bool for a nullable
funding_path (ptr+len UTF-8 BIP32 string) and removed error code 30, so
the old Swift signature no longer compiles.

- PlatformWalletManagerShieldedFunding.swift: allowCrossDomain: Bool ->
  fundingPath: String? = nil; marshal the optional path as raw UTF-8
  bytes via a new withOptionalFundingPath helper (nil/empty -> nil ptr +
  0 len), mirroring withOptionalSurplusOutput, and pass funding_path_ptr/
  funding_path_len to the C function.
- PlatformWalletResult.swift: drop the errorAssetLockCrossDomainConsentRequired
  (code 30) FFI case and the assetLockCrossDomainConsentRequired
  PlatformWalletError case and their mappings.
- SwiftExampleApp ShieldedFundFromAssetLockView: replace the cross-domain
  consent toggle with an optional funding-path text field; pass fundingPath
  (nil when blank) to the SDK call.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…re-scope

The dashpay#4184 re-scope dropped AssetLockCrossDomainConsentRequired (code 30) but
left references behind: a DashSdkErrorTest mapping (broke :sdk:test compile),
the rs-platform-wallet-ffi README ABI note, and a shielded_send.rs comment.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
bfoss765 added a commit to bfoss765/platform that referenced this pull request Jul 23, 2026
…the signer wire

Replace end-to-end message sniffing for the signer's "missing key" failure
with a typed discriminator (dashpay#4060 finding 7):

- rs-sdk-ffi: DashSDKSignerErrorCode { Generic = 0, SigningKeyUnavailable =
  1, AuthenticationFailed = 2 (reserved) }; SignCompletionCallback and
  dash_sdk_sign_async_completion gain error_code: i32 (before
  error_message). SignResult stays Result<Vec<u8>, ProtocolError> (a new
  rs-dpp ProtocolError variant would carry serialization blast radius), so
  code 1 rides the single Rust-owned machine prefix
  DASH_SDK_SIGNER_ERR_KEY_UNAVAILABLE_PREFIX through
  ProtocolError::Generic — typed at both ABI edges, one constant bridging
  the string segment. This is an internal coordinated ABI change: every
  piece versions together in this monorepo.
- rs-platform-wallet-ffi: PlatformWalletFFIResultCode::
  ErrorSigningKeyUnavailable = 31 (codes 26-28 are reserved for dashpay#4185's
  reservation-token errors and 29/30 for dashpay#4184's asset-lock errors on
  sibling branches — documented in the enum as dashpay#4184 does). The
  From<dpp::ProtocolError> conversion restores the typed code from the
  prefix FIRST (before the loose keyword sniffs), and the
  From<PlatformWalletError> blanket impl restores it on the catch-all only
  (dedicated retry-semantics codes are never overridden) — covering the
  Sdk(dash_sdk::Error::Protocol(..)) wrapping path.
- JNI/Kotlin: SignerNative.completeSign(token, signature, errorCode,
  errorMessage); KeystoreSigner passes SIGNER_ERROR_CODE_KEY_UNAVAILABLE on
  the null-key branch (keeping the MESSAGE_MARKER text for the transition
  window) and Generic everywhere else. DashSdkError maps 31 →
  PlatformWallet.SigningKeyUnavailable; the dashpay#4191 marker sniff on the
  catch-all codes remains as a deprecated old-native fallback with a
  removal note tied to the next minor release.
- Swift: KeychainSigner trampolines forward the code (missing-row /
  missing-scalar outcomes classify as 1); PlatformWalletResultCode gains
  errorSigningKeyUnavailable = 31 → PlatformWalletError
  .signingKeyUnavailable (Kotlin parity).
- Tests: rs-sdk-ffi completion-code tests (prefix present for code 1,
  absent for generic), platform-wallet-ffi prefix→31 tests on both
  conversion points, Kotlin code-31 + fallback-marker tests, Swift mapping
  and trampoline-classifier tests.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@bfoss765
bfoss765 force-pushed the port/v4.1/assetlock-multi-account branch from dfc670d to bfb1f49 Compare July 23, 2026 01:12
@shumkov

shumkov commented Jul 23, 2026

Copy link
Copy Markdown
Collaborator

Consolidated follow-up on the re-scope (joint verdict from both review tracks).

The single-selected-account redesign is the right resolution of the earlier privacy blocker — consent could never undo on-chain input clustering, and scoping selection to one account eliminates it. Accordingly: the multi-account reservation-ledger blocker is withdrawn as obsolete (rust-dashcore#912 remains good upstream work but is no longer this PR's dependency), and the Swift 29/30 compile fix is confirmed on the current head.

Changes are still requested — three new findings on the re-scoped code:

  1. Selected funding inputs are never reserved. build_asset_lock_tx_from_selected_account deliberately "runs without a reservation set" (build.rs:~251), justified by the wallet write lock + shield_guard — but those protect concurrent builds only. Nothing protects the build→broadcast→reconciliation window from a concurrent normal Core send or CoinJoin mix (neither takes shield_guard) selecting the same UTXOs — the exact window ReservationSet exists for, and the pre-PR BIP44 path did reserve. Please reserve the selected inputs in the funding account's own ledger (the single-account reservation machinery already exists upstream), or hold for a ci: self-hosted runners and cache #912-style atomic commit.
  2. The example app still blocks the kotlin-sdk: shieldedFundFromAssetLock coin selection only reaches one account (CoinJoin/other-account funds unspendable) #4073 scenario. The funding picker lists only BIP44 accounts (typeTag == 0 && standardTag == 0, ShieldedFundFromAssetLockView.swift:~834) and canSubmit still requires the selected BIP44 balance to cover the amount — a CoinJoin fundingPath cannot be exercised end-to-end.
  3. JNI: fail loud on a bad fundingPath. read_cstring_opt clears a JNI read error and returns None — acceptable for a memo, wrong for a money-source parameter: an explicitly-passed path silently degrades to default BIP44 funding (funding.rs:~242). Throw instead.

Moderate:

  1. Generic shielded-funding failures now surface as Unknown(99) instead of WalletOperation(6) (shielded_send.rs:1085) — a host-facing regression.
  2. Doc/description drift from the re-scope: orchestration.rs:124 still describes the deleted union design; the PR description's "Review-response summary" still documents the consent gate, code 30, and the allow_cross_domain C-ABI note (now funding_path); CodeRabbit's stale-comment find at shielded_send.rs:1079-1085 is the same drift. Please rewrite the description to the as-built design.

Advisory: CoinJoin-funded locks route change to the BIP44 account (upstream limitation — non-Standard accounts can't derive change), so change-bearing spends still create one CoinJoin→BIP44 link. Prefer change-free selection when feasible (denomination/fee constraints permitting) and document the residual linkage.

CI: still zero Rust/Swift jobs on this fork PR — local 507/507 doesn't exercise the reservation window. Same ask as before: a same-repo ref run before merge.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants