A capability is the smallest selectable unit of app-chain behavior. A
recipe is a reviewed bundle of them.
This page is generated at documentation build time from
tooling/devtools/src/main/resources/appchain-dx/v1alpha1/appchain-capability-catalog.json.
For your exact build, ask the binary:
./yano.sh appchain capabilities
./yano.sh appchain capabilities --format json
Field Meaning Availability BUNDLED ships in the distribution; FIRST_PARTY_OPTIONAL needs its release-matched plugin bundle installed; EXPERIMENTAL may change; REFERENCE is a documented workflow.Maturity stable, preview, or experimental.Runtimes jvm, and native only for the handful of core capabilities. Yano X extensions are JVM-only.Requires artifacts The runtime artifacts that must be present. yano-runtime means the host itself.
Capabilities also declare requires, implies, and conflicts relationships.
The CLI and Studio resolve those for you; a conflicting selection
fails closed rather than picking one.
Capability Availability Maturity Runtimes Requires artifacts Description state:ordered-logBUNDLEDstablejvm, nativeyano-runtimeAppend-only ordered application messages. state:kv-registryBUNDLEDstablejvmyano-runtime, yano-x-stdlibFirst-writer-owned mutable key/value records with committed proofs. state:authenticated-mapBUNDLEDpreviewjvmyano-runtime, yano-x-stdlib, yano-x-role-workflowMulti-collection authenticated records with basic, direct-role, and approval authorization plus optional canonical-CBOR and schema validation. state:approval-workflowBUNDLEDstablejvmyano-runtime, yano-x-stdlibValidator-member proposals, votes, and terminal threshold decisions. state:balancesBUNDLEDstablejvmyano-runtime, yano-x-stdlibMember-authorized mint and transfer accounts for bounded application balances. state:doc-trailBUNDLEDstablejvmyano-runtime, yano-x-stdlibAppend-only per-entity document and event hash trails. state:evidence-registryBUNDLEDpreviewjvmyano-runtime, yano-x-evidence-registryInspection and compliance evidence records with exact committed query proofs. state:role-approvalsBUNDLEDpreviewjvmyano-runtime, yano-x-composite, yano-x-role-workflowGoverned organizations, actors, policies, and signed approvals for arbitrary payload hashes. state:role-evidenceBUNDLEDpreviewjvmyano-runtime, yano-x-stdlib, yano-x-evidence-registry, yano-x-composite, yano-x-role-workflow, yano-x-evidence-profileEvidence registration combined with governed domain actors and role-aware release approval. state:zk-gateEXPERIMENTALexperimentaljvmyano-runtime, yano-x-zkVerifies configured Groth16 or Plonk proofs during deterministic state transition. state:zk-membershipEXPERIMENTALexperimentaljvmyano-runtime, yano-x-zkMembership authorization using a configured zero-knowledge circuit and nullifier deduplication. state:credential-registryEXPERIMENTALexperimentaljvmyano-runtime, yano-x-zkRegistry for selectively disclosed BBS credential statements from configured issuers. state:eutxo-ledgerFIRST_PARTY_OPTIONALexperimentaljvmyano-runtime, yano-x-eutxo-ledgerDeterministic Cardano-shaped EUTxO state, root-fixed receipts, address indexes, and MPF-proven outputs under one explicitly selected ledger profile.
Capability Availability Maturity Runtimes Requires artifacts Description state:custom-pluginREFERENCEexperimentaljvmyano-runtimeProject boundary for a separately reviewed custom state-machine bundle.
Capability Availability Maturity Runtimes Requires artifacts Description profile:eutxo-plutus-v3FIRST_PARTY_OPTIONALexperimentaljvmyano-runtime, yano-x-eutxo-ledgerPins the immutable yano-eutxo-v2-plutus-v3 ledger profile and every consensus-relevant bound. profile:eutxo-bridge-settlementFIRST_PARTY_OPTIONALexperimentaljvmyano-runtime, yano-x-eutxo-ledgerPins the immutable yano-eutxo-v3-bridge-settlement ledger profile (ADR-UTXO-009) and every consensus-relevant bound. profile:eutxo-key-paymentsFIRST_PARTY_OPTIONALexperimentaljvmyano-runtime, yano-x-eutxo-ledgerPins the immutable yano-eutxo-v1 ledger profile used by the current bounded ZeroJ validity circuit.
Capability Availability Maturity Runtimes Requires artifacts Description funding:eutxo-genesisFIRST_PARTY_OPTIONALexperimentaljvmyano-runtime, yano-x-eutxo-ledgerBootstraps one explicit ADA-only virtual allocation for no-real-funds testing.
Capability Availability Maturity Runtimes Requires artifacts Description bridge:cardano-federatedEXPERIMENTALexperimentaljvmyano-runtime, yano-x-eutxo-ledger, yano-x-eutxo-bridge-cardanoObserves exact accepted vault deposits and settles irrevocable bounded claims through either exact external signing or permissionless current-root MPF proofs with an on-chain replay nullifier.
Capability Availability Maturity Runtimes Requires artifacts Description settlement:zeroj-validityEXPERIMENTALexperimentaljvmyano-runtime, yano-x-eutxo-zk-zeroj, yano-x-eutxo-zk-runtime, yano-x-eutxo-zk-lifecycleAdds a Yano L2 envelope with a Cardano-compatible body, registered Jubjub session-key authorization, optional Poseidon validity commitment, durable proving interfaces, proof-bound Cardano root advancement, bounded aggregate withdrawal and canonical L1 batch publication.
Capability Availability Maturity Runtimes Requires artifacts Description rollup:zeroj-cardanoEXPERIMENTALexperimentaljvmyano-runtime, yano-x-eutxo-ledger, yano-x-eutxo-zk-zerojGraduation label for a separately approved ZeroJ validity product; it does not add runtime behavior.
Capability Availability Maturity Runtimes Requires artifacts Description indexer:eutxo-lifecycleFIRST_PARTY_OPTIONALpreviewjvmyano-runtime, yano-x-eutxo-indexer-core, yano-x-eutxo-indexer-jdbcIndexes finalized EUTxO transactions, accounts, bridge lifecycle records, and optional validity batches for bounded APIs and the unified console.
Capability Availability Maturity Runtimes Requires artifacts Description sequencer:fixedBUNDLEDstablejvm, nativeyano-runtimeOne declared member proposes application blocks. sequencer:rotatingBUNDLEDexperimentaljvm, nativeyano-runtimeRotates proposership across members using bounded L1 slot windows.
Capability Availability Maturity Runtimes Requires artifacts Description membership:staticBUNDLEDstablejvm, nativeyano-runtimePins the initial member set as the active set. membership:governedBUNDLEDpreviewjvm, nativeyano-runtimeAllows authenticated member epochs to evolve through replicated governance.
Capability Availability Maturity Runtimes Requires artifacts Description l1:slot-feedBUNDLEDstablejvm, nativeyano-runtimeSupplies stable local Cardano slot observations to slot-aware app-chain behavior.
Capability Availability Maturity Runtimes Requires artifacts Description anchor:metadataBUNDLEDstablejvm, nativeyano-runtimeCommits finalized app-chain roots in Cardano transaction metadata. anchor:scriptBUNDLEDpreviewjvm, nativeyano-runtimeAdvances an app-chain anchor thread through a reviewed Cardano script.
Capability Availability Maturity Runtimes Requires artifacts Description observer:address-depositBUNDLEDpreviewjvm, nativeyano-runtimeCreates stable observations for lovelace paid to one configured Cardano address. observer:metadata-labelBUNDLEDpreviewjvm, nativeyano-runtimeCreates stable observations for one configured Cardano transaction metadata label.
Capability Availability Maturity Runtimes Requires artifacts Description effects:runtimeBUNDLEDpreviewjvm, nativeyano-runtimeEnables deterministic effect intents, gates, result incorporation, and proofs.
Capability Availability Maturity Runtimes Requires artifacts Description effects:on-approvedBUNDLEDpreviewjvmyano-runtime, yano-x-stdlibEmits one typed chain-result effect when a stock approval reaches its threshold.
Capability Availability Maturity Runtimes Requires artifacts Description executor:webhookBUNDLEDpreviewjvm, nativeyano-runtimeExecutes webhook.post effects against one node-local configured URL. executor:kafkaFIRST_PARTY_OPTIONALpreviewjvmyano-runtime, yano-x-kafkaExecutes kafka.publish intents through allowlisted node-local Kafka targets. executor:objectstore-s3FIRST_PARTY_OPTIONALpreviewjvmyano-runtime, yano-x-objectstore-s3Executes immutable object.put promotion against allowlisted S3-compatible targets. executor:ipfsFIRST_PARTY_OPTIONALpreviewjvmyano-runtime, yano-x-ipfsExecutes reconciled ipfs.pin intents against allowlisted Kubo targets. executor:cardano-paymentFIRST_PARTY_OPTIONALpreviewjvmyano-runtime, yano-x-effects-cardanoExecutes bounded cardano.payment intents from an operator-controlled payer wallet.
Capability Availability Maturity Runtimes Requires artifacts Description sink:webhookBUNDLEDstablejvm, nativeyano-runtimePosts finalized application blocks to one configured node-local webhook endpoint. sink:kafkaFIRST_PARTY_OPTIONALpreviewjvmyano-runtime, yano-x-kafkaPublishes finalized application blocks to a configured Kafka topic.
Capability Availability Maturity Runtimes Requires artifacts Description runtime:compositeBUNDLEDpreviewjvmyano-x-compositeDeterministic component, workflow, profile, query, quota, and profile-governance framework. ui:consoleBUNDLEDpreviewjvm, nativeyano-runtimeEmbedded operational app-chain status console derived from the selected Yano distribution. observability:prometheusFIRST_PARTY_OPTIONALpreviewjvm, nativeyano-runtimeOptional one-command durable metrics history for the unified console.
Each artifact is an independently published, dependency-complete plugin bundle
with its own version. The bundleId is what appears in a plugin manifest and
in the distribution’s checksummed bundle list.
Artifact Availability Plugin bundle id Runtimes Native posture yano-runtimeBUNDLEDbuiltin:yano-runtimejvm, nativebundledyano-x-stdlibBUNDLEDcom.bloxbean.cardano.yano.appchain.stdlibjvmunsupportedyano-x-evidence-registryBUNDLEDcom.bloxbean.cardano.yano.appchain.evidence-registryjvmunsupportedyano-x-compositeBUNDLEDlibrary:composition:runtimejvmunsupportedyano-x-role-workflowBUNDLEDcom.bloxbean.cardano.yano.appchain.role-workflowjvmunsupportedyano-x-evidence-profileBUNDLEDcom.bloxbean.cardano.yano.appchain.evidence-profilejvmunsupportedyano-x-kafkaFIRST_PARTY_OPTIONALcom.bloxbean.cardano.yano.appchain.kafkajvmunsupportedyano-x-objectstore-s3FIRST_PARTY_OPTIONALcom.bloxbean.cardano.yano.appchain.objectstore.s3jvmunsupportedyano-x-ipfsFIRST_PARTY_OPTIONALcom.bloxbean.cardano.yano.appchain.ipfsjvmunsupportedyano-x-effects-cardanoFIRST_PARTY_OPTIONALcom.bloxbean.cardano.yano.appchain.effects.cardanojvmunsupportedyano-x-zkEXPERIMENTALcom.bloxbean.cardano.yano.appchain.zkjvmunsupportedyano-x-eutxo-ledgerBUNDLEDcom.bloxbean.cardano.yano.appchain.eutxojvmunsupportedyano-x-eutxo-indexer-coreBUNDLEDcom.bloxbean.cardano.yano.appchain.eutxo.indexerjvmunsupportedyano-x-eutxo-indexer-jdbcBUNDLEDlibrary:ledgers:eutxo:indexer-jdbcjvmunsupportedyano-x-eutxo-bridge-cardanoBUNDLEDcom.bloxbean.cardano.yano.appchain.eutxo.bridge.cardanojvmunsupportedyano-x-eutxo-zk-zerojBUNDLEDlibrary:ledgers:eutxo-zk:zerojjvmunsupportedyano-x-eutxo-zk-runtimeBUNDLEDlibrary:ledgers:eutxo-zk:runtimejvmunsupportedyano-x-eutxo-zk-lifecycleBUNDLEDlibrary:ledgers:eutxo-zk:lifecyclejvmunsupported
Distribution Runtime Archive Platforms Bundled artifacts yano-x-jvmjvmyano-x-jvm-{version}.zipjava-2513
A FIRST_PARTY_OPTIONAL capability is maintained and tested by Yano X but is
not selected in every deployment. Using one means:
installing the exact release-matched bundle in plugins/ on every
applicable node;
providing the external service it talks to; and
configuring its endpoints and credentials as node-local values — never
in replicated effect payloads or consensus-shared configuration.
tools/yano-plugins/bin/yano-plugins validate plugins/ * .jar
./yano.sh appchain doctor <project> --distribution /opt/yano-x
See the
optional connector installation guide
for per-connector requirements and security profiles.
The standard eUTxO runtime and the eUTxO ZK runtime both provide
app-state-machine/eutxo-ledger. Exactly one may be installed, which is why the
ZK runtime ships under optional-plugins/. See
eUTxO and ZK .
