English source · 3 min
Veyndo App Runtime
Execute real core-Wasm and WIT commerce guests without a Veyndo server,
database, HTTP client or identity service. The embedding host supplies the
reviewed module, already-authorized snapshot and required ResourcePolicy.
cargo run --locked --manifest-path runtime/Cargo.toml --example quote -- 25000
cargo test --locked --manifest-path runtime/Cargo.toml
The example executes a real read-only price hook. With a 25,000 minor-unit cart it returns a 250 minor-unit adjustment. Example source.
Native integration
The composed Veyndo product uses this same pinned source. Its small veyndo-apps
adapter supplies the existing verified resource predicate and operator-configured
legacy namespace list. Current merchant rights, package/digest fences, authorized
snapshot construction and applying the outcome remain with native owners. Module
compilation is prepared outside commerce locks using the existing bounded cache.
A returned adjustment is a proposal, not an order mutation or payment authority.
API
sandbox::Sandbox::new(source, policy, namespaces)compiles a no-import core-Wasm module or a typed commerce component. Core guests expose integer approval and configuration hooks. Every call gets a fresh store.component_runtime::Module::new(source, policy, namespaces)compiles the WIT contract in wit/commerce.wit.validate_interfacechecks its actual ABI;evaluateexecutes price, shipping, discount or validation hooks.ResourcePolicy::admitted(Resources)is mandatory. There is no permissive default. Implement it from the embedding host's canonical policy owner, never package or HTTP request flags. The runtime also retains its own engine/store limits.Snapshotcontains supplied cart, product and app-record values only. The guest can read that snapshot; it cannot fetch other data or access host credentials.
The core approval ABI is separate from the WIT ABI. A compiled core module may lack an expected function; calling that hook still rejects the wrong ABI. Always validate the actual required interface before installing a package.
Preserved limits
Source is limited to 32 KiB; stores retain at most one 1 MiB memory and 10,000 table elements. A bounded 64-instance engine pool, limited stack, per-call fuel and epoch deadlines remain active. Core calls use 10,000 fuel and ten 10 ms epochs; WIT calls use 100,000 fuel and five epochs. A component can make at most 128 read-only host calls. Engine exhaustion and traps return errors.
WIT snapshots retain at most 100 cart items/products, 32 records and 64 KiB record content; input is at most 8 KiB. Money currency/scale and output adjustments/reason codes retain their original checks. Validation hooks cannot adjust money. Core configuration calls accept one to eight declared integer arguments. No WASI, network, filesystem, database or secret imports are installed.
The separate runtime service now supplies current OAuth access, HTTP/OpenAPI/MCP and SDK examples using this unchanged execution library.
Limits are per process/call and use Wasmtime; they are not an OS process boundary or fleet-wide quota. Resource admission and execution do not authenticate a caller, create a package grant, or establish a standalone Apps API/MCP service.
The WIT file here is the compiler input; the composed Core checks that its SDK contract mirror has identical bytes. Fixtures preserve the original synthetic examples with repository provenance. Independent CI runs the original guest regressions, explicit host denial, fresh-store/source-identity, namespace and snapshot guards. Native composition additionally tests actual quote/checkout, configuration, preview, release, API/MCP, current rights and tenant isolation.
Business preflight
cargo run --locked --manifest-path runtime/Cargo.toml --example business_preflight
validates and executes the original structured material/dimension configuration
and frozen commerce examples without a Core process, database or inference.
Changed expected values or changed/trapping guests reject the business examples.
Runtime 0.2.0 uses the shared pure veyndo-app-model contracts:
business_snapshot::snapshotprojects an already-admitted synthetic snapshot into the original WIT types. It does not read live records or confer authority.business_examples::verifyexecutes admitted capability examples through the same boundedSandboxand preserves/capability/examples/.../expectederrors. First run the model validators with real host policies and validate the ABI.configuration::runexecutes the existing integer contribution function or fee probe, retaining its exact result bounds. Validate and select fields with the shared model configuration functions before calling it.
The native adapter retains canonical field/currency/reference policies, current package/digest selection, library record ownership and async preparation. It calls these same model and execution functions. A successful synthetic example neither publishes a package nor authorizes a checkout mutation. Full typed native domain compilation, identity and standalone API/MCP hosting remain separate tracked work.