HYBRID-CHAINDEVELOPERS
DOCUMENTATIONv2

BUILD · MODULE 19

Execution Studio

Create, validate, publish, deploy, invoke, trigger, and verify deterministic execution packages under immutable artifact, schema, sandbox, resource, node-attestation, and external-domain authority boundaries.

BUSINESS CASES

Where this module fits

  • content-addressed package development
  • reproducible build and policy validation
  • immutable private, workspace, or public publication
  • isolated test and production deployment
  • schema-bound deterministic invocation
  • event and schedule triggers
  • operator and node attestation review
  • execution receipt and output verification

PRIMARY CONSUMERS

Who integrates it

  • execution package developers
  • platform and node operators
  • verification and reproducibility agents
  • security, policy, and supply-chain reviewers

PREREQUISITES

What must exist first

  • execution:read or execution:write in the bearer-derived workspace
  • an immutable owner-scoped source artifact and canonical SHA-256 digest
  • approved runtime and validation profiles with pinned compiler, runtime, ABI, and dependency policy
  • closed input/output schemas, dependency-lock commitment, capability request, and resource limits
  • eligible attested nodes and isolated environment policy for deployment
  • fresh owning-domain authorization for any effect beyond pure deterministic compute
  • caller-owned acceptance rules for validation freshness, node attestation, reproducibility, outputs, logs, receipts, and finality

RECOMMENDED WORKFLOW

Compose the module safely.

  1. 01

    ingest live OpenAPI and discover approved runtime, validation, capability, network, node, and resource profiles

  2. 02

    create a private DRAFT from an immutable source artifact, exact digest, closed manifest, declared capabilities, and bounded resource policy

  3. 03

    revise only the editable draft and invalidate any validation derived from changed commitments

  4. 04

    validate the exact source, manifest, dependencies, schemas, runtime images, capabilities, policy, reproducibility, and sandbox behavior

  5. 05

    publish one validated package version immutably at the admitted visibility

  6. 06

    prepare an isolated TEST or PRODUCTION deployment whose limits only narrow package and platform policy

  7. 07

    validate invocation inputs before executing and obtain fresh owner-issued authority for any external domain effect

  8. 08

    create and govern typed triggers separately from deployment and invocation

  9. 09

    verify package, build, input, output, runtime, node, resource, signature, and any separate domain receipt commitments together

MODULE CONTRACTS

Every mapped endpoint

Each operation states whether its request shape is authoritative in OpenAPI, reviewed as a planning profile, or intentionally left as an outline pending an owner schema.

GETGet execution mode/api/v2/ai-wallets/{binding_id}/execution-modeReturn the persisted execution mode and every unmet autonomy gate; this read never creates or changes authority.GETList collateral balances/api/v2/balancesReturn purpose-limited available and reserved collateral balances.GETList markets/api/v2/marketsList canonical market definitions for the DEX, securities, or virtual venue without embedding prices, order books, or user state.GETGet market/api/v2/markets/{market_id}Return one canonical venue-scoped market definition without embedding prices, order books, or user state.GETList candles/api/v2/markets/{market_id}/candlesAggregate bounded venue-scoped trades into deterministic OHLCV intervals.GETList market events/api/v2/markets/{market_id}/eventsReturn sequenced venue events for one canonical market.GETGet funding rates/api/v2/markets/{market_id}/funding-ratesReturn the configured funding rate for a perpetual market.GETGet restrictions/api/v2/markets/{market_id}/restrictionsReturn owner-specific matching restrictions without exposing other traders.GETList market trades/api/v2/markets/{market_id}/tradesReturn a bounded recent execution window for one canonical venue-scoped market with duplicate matching sides collapsed.GETGet order/api/v2/orders/{order_uuid}Return an order, fills, fees, cancellation state, and retained execution evidence.POSTCancel order/api/v2/orders/{order_uuid}/cancellationsRequest cancellation of an eligible open order.POSTReplace order/api/v2/orders/{order_uuid}/replacementsAtomically cancel and replace an eligible order with revised terms.POSTCancel all orders/api/v2/orders/cancellationsCancel every eligible owner-scoped order, optionally restricted to one market and venue.GETList positions/api/v2/positionsList current and historical trading positions and realized/unrealized performance.POSTClose position/api/v2/positions/{market_id}/closuresSubmit a reduce-only market command whose side is derived from the live owner-scoped position.GETList trades/api/v2/tradesList authenticated trade executions with market, order, settlement, and fee filters.GETGet trade/api/v2/trades/{trade_uuid}Return one exact owner-scoped trade execution.GETGet last trade/api/v2/markets/{market_id}/last-tradeReturn the latest distinct execution for one canonical venue-scoped market, or an explicit null when no trade exists.GETList deployments/api/v2/execution/deploymentsPlanned capability: list package deployments and their current state.POSTCreate deployment/api/v2/execution/deploymentsPlanned capability: create a policy-bound package deployment.POSTInvoke deployment/api/v2/execution/deployments/{deployment_uuid}/invocationsPlanned capability: invoke an active deployment with validated inputs and idempotency.GETList executions/api/v2/execution/executionsPlanned capability: list execution records and deterministic receipts.GETGet execution/api/v2/execution/executions/{execution_uuid}Planned capability: return one execution, its logs, outputs, attestations, and receipt.GETList nodes/api/v2/execution/nodesPlanned capability: list execution nodes and their attested health.GETList operators/api/v2/execution/operatorsPlanned capability: list execution operators and authority statements.GETList packages/api/v2/execution/packagesPlanned capability: list deterministic execution packages visible to the caller.POSTCreate package/api/v2/execution/packagesPlanned capability: create a versioned deterministic execution package.GETGet package/api/v2/execution/packages/{package_uuid}Planned capability: return package source, manifest, policy, and verification state.PATCHUpdate package/api/v2/execution/packages/{package_uuid}Planned capability: update an editable execution package draft.POSTPublish package/api/v2/execution/packages/{package_uuid}/publicationsPlanned capability: publish a validated immutable package version.POSTValidate package/api/v2/execution/packages/{package_uuid}/validationsPlanned capability: validate package source, manifest, declared capabilities, and signed policy.GETList triggers/api/v2/execution/triggersPlanned capability: list schedule, event, and API triggers.POSTCreate trigger/api/v2/execution/triggersPlanned capability: create a policy-bound trigger for a deployment.PATCHUpdate trigger/api/v2/execution/triggers/{trigger_uuid}Planned capability: pause, resume, or revise an eligible trigger.GETList hybridscript executions/api/v2/explorer/execution/executionsList hybridscript executions from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETGet hybridscript execution/api/v2/explorer/execution/executions/{identifier}Return hybridscript execution from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETList hybridscript nodes/api/v2/explorer/execution/nodesList hybridscript nodes from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETGet hybridscript node/api/v2/explorer/execution/nodes/{identifier}Return hybridscript node from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETList hybridscript operators/api/v2/explorer/execution/operatorsList hybridscript operators from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETGet hybridscript operator/api/v2/explorer/execution/operators/{identifier}Return hybridscript operator from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETList execution packages/api/v2/explorer/execution/packagesList execution packages from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETGet execution package/api/v2/explorer/execution/packages/{identifier}Return execution package from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETGet execution publishing authority/api/v2/explorer/execution/publishing-authorityList execution publishing authority from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETGet strategy/api/v2/explorer/strategies/{execution_uuid}Return strategy from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.