Skip to content

docs(language): automatic reference inputs for ref-backed policies#56

Merged
scarmuega merged 2 commits into
mainfrom
docs/policy-ref-reference-input
Jun 7, 2026
Merged

docs(language): automatic reference inputs for ref-backed policies#56
scarmuega merged 2 commits into
mainfrom
docs/policy-ref-reference-input

Conversation

@scarmuega

Copy link
Copy Markdown
Contributor

Documents new behavior shipped in tx3#332: a policy declared with a ref field, when used as an input's from or as a mint/burn policy, automatically contributes its ref UTxO to the transaction's reference inputs (deduped).

Changes

  • language/policies.md — rewrote "Pairing a policy with a witness" into two clear paths: reference scripts (ref, automatic) vs inline scripts (cardano::*_witness, explicit), with a worked example. Clarified the ref field-table row.
  • language/txs.md — noted on the input from field and the mint/burn section that a ref-backed policy's reference-script UTxO is attached automatically.

Accuracy notes

  • Auto-injection applies to ref (reference scripts) only — inline script bytes still need a witness block.
  • Hash-only policies contribute no reference input.

🤖 Generated with Claude Code

scarmuega and others added 2 commits June 7, 2026 11:21
…licies

A policy declared with a `ref` field, when used as an input's `from` or
as a mint/burn policy, now automatically contributes its `ref` UTxO to
the transaction's reference inputs. Document this in the policies and
txs guides, and distinguish it from inline `script` bytes (which still
require a `cardano::*_witness` block).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Clarify that the `reference` block is the explicit way to attach a
reference script (when not using a ref-backed policy), not only a way to
read oracle datums, and that reference inputs are deduplicated.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@scarmuega scarmuega merged commit 60be880 into main Jun 7, 2026
@scarmuega scarmuega deleted the docs/policy-ref-reference-input branch June 7, 2026 14:28
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.

1 participant