Skip to content

docs(design): funding modality overview - #1551

Open
filvecchiato wants to merge 853 commits into
mainfrom
docs/funding-modality
Open

filvecchiato wants to merge 853 commits into
mainfrom
docs/funding-modality

Conversation

@filvecchiato

@filvecchiato filvecchiato commented Oct 20, 2026 •

Copy link
Copy Markdown
Collaborator

Docs only, against main. Diagrams first, short captions.

Rendered

  • Funding modality: parts and ownership, interfaces, the host loop (funding_changed(intent, kind) → read back), top-up and withdrawal sequences, session lifecycle, cancel, funds a worker moves, storage, restart and worker crash, the numbers.
  • Building a funding provider: the whole flow, screen shapes, manifest, handlers, quote rules, inbound and outbound steps, frames, Progress facts, cancels, restarts, testing, checklist.

Both are linked from the README.

@filvecchiato
filvecchiato requested a review from a team as a code owner October 20, 2026 09:11
@filvecchiato filvecchiato added the ci:no-changeset Changes no published artifact, so the changeset check passes without one label Oct 20, 2026
@github-actions github-actions Bot added the area:docs Touches documentation label Oct 20, 2026
@github-actions

github-actions Bot commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor

CI Status: 26 required jobs green, 16 passed and 10 skipped by path filter.

All job results
job result
android-app skipped
android-bindings skipped
bundle-size success
changes success
changeset-guard skipped
cli-package skipped
codegen success
e2e skipped
explorer success
headless-install success
host-wasm success
install-action skipped
ios-app skipped
ios-bindings success
ios-lint skipped
licenses success
playground success
provider-android-bindings skipped
release-guard success
rust success
ts-client success
ts-debugger success
ts-host success
ts-trinity-stack success
wasm-provider success
workflow-lint skipped

Signing credentials: valid as of 2026-11-18

Commit f54dbae8 · run log

@github-actions

github-actions Bot commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor

Bundle size report

Compared with main at 8c61cfa.

Raw Gzip Brotli
truapi-host 8.85 MiB 5.98 MiB 5.61 MiB
truapi-provider 4.04 MiB 1.27 MiB 962.0 KiB
truapi 8.76 MiB 1.23 MiB 1019.6 KiB
trinity-stack 635.6 KiB 248.0 KiB 205.0 KiB
Total 22.27 MiB 8.73 MiB 7.75 MiB

WebAssembly modules

Raw Gzip Brotli
truapi-host/wasm/web/truapi_server_bg.wasm 3.72 MiB 1.28 MiB 972.9 KiB
truapi-host/wasm/web/truapi_verifiable_bg.wasm 4.89 MiB 4.64 MiB 4.61 MiB
truapi-provider/truapi_provider_bg.wasm 4.00 MiB 1.27 MiB 954.2 KiB
trinity-stack/wasm/trinity_stack_bg.wasm 565.8 KiB 231.0 KiB 190.2 KiB

No file changed size.

Commit: f54dbae

@github-actions

Copy link
Copy Markdown
Contributor

This pull request touches an app, which is not built by default. Add a label for each build you want:

  • iOS simulator build, ios-simulator-build: builds the iOS app and attaches a build for the iOS Simulator on a Mac; its unit tests run on every pull request.
  • iOS device build, ios-device-build: attaches a signed build that installs on a registered iPhone or iPad.
  • Android build, android-device-build: attaches an APK that installs on an Android phone or an emulator.

Each starts as soon as it is added and follows the branch from then on.

@github-actions github-actions Bot added area:ios Touches the iOS host app or the iOS packages area:android Touches the Android host app or the Android packages labels Oct 28, 2026
@filvecchiato
filvecchiato changed the base branch from funding/host-gaps to hosts/android-cash-card October 28, 2026 09:26
@filvecchiato
filvecchiato added this pull request to stack #1716 October 28, 2026 09:26
@github-actions github-actions Bot added size:L Pull requests only. 500 to 999 lines changed status:waiting-on-review Ready for a reviewer labels Oct 30, 2026
@filvecchiato
filvecchiato marked this pull request as draft November 2, 2026 08:57
@filvecchiato
filvecchiato requested a review from a team as a code owner November 2, 2026 08:57
@github-actions github-actions Bot added size:XL Pull requests only. 1000 to 1999 lines changed; consider splitting and removed size:L Pull requests only. 500 to 999 lines changed status:waiting-on-review Ready for a reviewer labels Nov 2, 2026
@filvecchiato
filvecchiato marked this pull request as ready for review November 6, 2026 16:45
@github-actions github-actions Bot added the status:waiting-on-review Ready for a reviewer label Nov 6, 2026
Base automatically changed from funding/host-gaps to main November 6, 2026 17:39
@filvecchiato filvecchiato linked an issue Nov 11, 2026 that may be closed by this pull request
# Conflicts:
#	.changeset/funding-providers.md
#	README.md
#	rust/crates/truapi-codegen/tests/golden/host-callbacks.ts
#	rust/crates/truapi-codegen/tests/golden/wire_table.rs
#	rust/crates/truapi/RUNTIME.md
#	rust/crates/truapi/src/host_core.rs
#	rust/crates/truapi/src/host_logic/funding.rs
#	rust/crates/truapi/src/host_logic/funding_providers.rs
#	rust/crates/truapi/src/host_logic/funding_providers/tests.rs
#	rust/crates/truapi/src/lib.rs
#	rust/crates/truapi/src/native/callbacks.rs
#	rust/crates/truapi/src/native/platform.rs
#	rust/crates/truapi/src/native/runtime.rs
#	rust/crates/truapi/src/native/tests.rs
#	rust/crates/truapi/src/platform.rs
#	rust/crates/truapi/src/runtime.rs
#	rust/crates/truapi/src/runtime/funding.rs
#	rust/crates/truapi/src/runtime/funding/store.rs
#	rust/crates/truapi/src/runtime/funding/tests.rs
#	rust/crates/truapi/src/runtime/funding_providers.rs
#	rust/crates/truapi/src/runtime/funding_providers/tests.rs
#	rust/crates/truapi/src/runtime/funding_quotes.rs
#	rust/crates/truapi/src/runtime/services.rs
#	rust/crates/truapi/src/runtime/tests.rs
@TarikGul TarikGul added size:L Pull requests only. 500 to 999 lines changed and removed size:XL Pull requests only. 1000 to 1999 lines changed; consider splitting labels Nov 18, 2026

This branch has not been deployed

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

Labels

area:android Touches the Android host app or the Android packages area:docs Touches documentation area:ios Touches the iOS host app or the iOS packages ci:no-changeset Changes no published artifact, so the changeset check passes without one size:L Pull requests only. 500 to 999 lines changed status:waiting-on-review Ready for a reviewer

Projects

None yet

Development

Successfully merging this pull request may close these issues.

RFC: Funding modality — quotes, rails, cancel

2 participants