CodeSampleX

示例

idna 1.1.0: idna

已验证示例 — cargo idna 1.1.0: idna. contract 在 rust 1 · linux alpine/x64 · docker 上运行并通过： domain_to_ascii converts internationalized domain names with Unicode…

sha256:4e1672707ac94bb45b9aeade8f0db73af644ca4810ad92cd30fd65da76ef5d6e

本网络只提供一件事：能构建的样本。它在沙箱中运行并保留签名回执。它不评级、不担保——同样的代码能否在你的环境构建，它没有测量过。 提交了通过的契约回执的不同签名密钥数量。为 1 表示只有作者；大于 1 表示还有其他人构建过。密钥是自行生成的，背后没有注册身份，因此计的是密钥而非人。 MIT-0

执行证据

声明的环境与签名的运行分开呈现，你可以看到这个样本究竟运行了什么、在哪里运行。

证据依据
签名契约通过
验证回执
1
构建过它的签名密钥
1
声明的环境 linux · alpine · musl x64 cargo

验证运行环境

环境 契约 阶段 运行日期
rust 1 · linux alpine/x64 · docker ed25519:c1973797be207ac4 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · cargo@1rust:1-alpine@sha256:a10e64dd139b…		 2026-10-09

案例

HOW
目标
verify idna in pkg:cargo/idna@1.1.0
包
符号
  • idna
创建时间
2026-10-09T07:47:23Z

契约

  1. domain_to_ascii converts internationalized domain names with Unicode characters to Punycode
  2. domain_to_unicode decodes Punycode ASCII domains back to Unicode representations
  3. domain_to_ascii_cow normalizes upper-case characters and enforces AsciiDenyList rules
  4. domain_to_ascii_strict validates domain syntax under strict rules
  5. punycode encodes Unicode strings to ASCII and decodes Punycode strings back to Unicode
  6. Uts46 provides low-level IDNA processing with configurable AsciiDenyList and Hyphens policies

文件

  • Cargo.lock
  • Cargo.toml
  • PROMPT.md
  • csx.json
  • spec.json
  • src/lib.rs
  • test/contract.rs

下载源代码构件 (tar.gz)

源代码

Cargo.lock
# This file is automatically @generated by Cargo.
# It is not intended for manual editing.
version = 4

[[package]]
name = "displaydoc"
version = "0.2.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "c6232dd377dcc64799954cbd3a9bb882e9cdc1308ccd87b1c098f1fb2eaf82a8"
dependencies = [
 "proc-macro2",
 "quote",
 "syn",
]

[[package]]
name = "icu_collections"
version = "2.3.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "fa68d21081c4a05d5a901a1c62add574c77048b6a1c67be3b50ce0b60d4ca513"
dependencies = [
 "displaydoc",
 "potential_utf",
 "utf8_iter",
 "yoke",
 "zerofrom",
 "zerovec",
]

[[package]]
name = "icu_locale_core"
version = "2.3.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d56e28588da92eee5c3201a6eff33fabdd49b62269c8938d4ff050ce4d900deb"
dependencies = [
 "displaydoc",
 "litemap",
 "tinystr",
 "writeable",
 "zerovec",
]

[[package]]
name = "icu_normalizer"
version = "2.3.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "12f9cf5f235641ed274641dd81c3f28d870e276763d0797aeeab72317b1c646f"
dependencies = [
 "icu_collections",
 "icu_normalizer_data",
 "icu_properties",
 "icu_provider",
 "smallvec",
 "zerovec",
]

[[package]]
name = "icu_normalizer_data"
version = "2.3.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1563da1ed3e0b3bf3d74c9b85917ac9c56464d2f57242270c09c9e752f8021a0"

[[package]]
name = "icu_properties"
version = "2.3.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7e7ca276ad3145661a65914e6daf131ca5120cd3dcee8f8f3214b8875184a148"
dependencies = [
 "displaydoc",
 "icu_collections",
 "icu_locale_core",
 "icu_properties_data",
 "icu_provider",
 "zerotrie",
 "zerovec",
]

[[package]]
name = "icu_properties_data"
version = "2.3.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e590f038c1464a96894fd6d10127e90a8be4509f56ff7ecef851b15cee0b7caa"

[[package]]
name = "icu_provider"
version = "2.3.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d27bbb9d3abbefac45d55f647c9de1d44aafcd1186eb91879afef17c396c3e73"
dependencies = [
 "displaydoc",
 "icu_locale_core",
 "writeable",
 "yoke",
 "zerofrom",
 "zerotrie",
 "zerovec",
]

[[package]]
name = "idna"
version = "1.1.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3b0875f23caa03898994f6ddc501886a45c7d3d62d04d2d90788d47be1b1e4de"
dependencies = [
 "idna_adapter",
 "smallvec",
 "utf8_iter",
]

[[package]]
name = "idna_adapter"
version = "1.2.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "cb68373c0d6620ef8105e855e7745e18b0d00d3bdb07fb532e434244cdb9a714"
dependencies = [
 "icu_normalizer",
 "icu_properties",
]

[[package]]
name = "litemap"
version = "0.8.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "47d9d19d1d6efa0109d2f65ff4c85cddd50bd572e5a00127ab10987290bcefae"

[[package]]
name = "potential_utf"
version = "0.1.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d83eb9bc6d8e5cf568e7a1101d60ee05e81ed50ea106026f3d18deeb046d7661"
dependencies = [
 "zerovec",
]

[[package]]
name = "proc-macro2"
version = "1.0.107"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
dependencies = [
 "unicode-ident",
]

[[package]]
name = "quote"
version = "1.0.47"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
dependencies = [
 "proc-macro2",
]

[[package]]
name = "sample-idna"
version = "1.0.0"
dependencies = [
 "idna",
]

[[package]]
name = "smallvec"
version = "1.16.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ba467056f1b547ed52077911161fc86985becbc60e8e1857c8a144dab0def891"

[[package]]
name = "stable_deref_trait"
version = "1.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "6ce2be8dc25455e1f91df71bfa12ad37d7af1092ae736f3a6cd0e37bc7810596"

[[package]]
name = "syn"
version = "3.0.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8593e8e72159ed2257d083c7a454a85cbf854f37a0966d8d483aff8c8a3ebcee"
dependencies = [
 "proc-macro2",
 "quote",
 "unicode-ident",
]

[[package]]
name = "synstructure"
version = "0.14.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "901704edd0dfe137f1987838ee4f259e4e063c31371bdb423f7ae38ec6f77f02"
dependencies = [
 "proc-macro2",
 "quote",
 "syn",
]

[[package]]
name = "tinystr"
version = "0.8.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b1e27c91459209c2986af3dcf603a5a74a4368754ce37414f59acc971167f643"
dependencies = [
 "displaydoc",
 "zerovec",
]

[[package]]
name = "unicode-ident"
version = "1.0.26"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d245f478577f809a851594d02313b640fb437e0bb33866753cff937863096954"

[[package]]
name = "utf8_iter"
version = "1.0.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b6c140620e7ffbb22c2dee59cafe6084a59b5ffc27a8859a5f0d494b5d52b6be"

[[package]]
name = "writeable"
version = "0.6.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3ad82d2a33cdc9674dc7465672f271e096168fcdbe0f799d9e6db8c5892679dc"

[[package]]
name = "yoke"
version = "0.8.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "709fe23a0424b6a435d82152b1bd3fdfb0833487d5fa90d05d42762a9891fef5"
dependencies = [
 "stable_deref_trait",
 "yoke-derive",
 "zerofrom",
]

[[package]]
name = "yoke-derive"
version = "0.8.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "33811428bee40dbceb6d545e95754741d17a6aef9a4849f0fd62e2ba4f412a78"
dependencies = [
 "proc-macro2",
 "quote",
 "syn",
 "synstructure",
]

[[package]]
name = "zerofrom"
version = "0.1.8"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0ec05a11813ea801ff6d75110ad09cd0824ddba17dfe17128ea0d5f68e6c5272"
dependencies = [
 "zerofrom-derive",
]

[[package]]
name = "zerofrom-derive"
version = "0.1.8"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f75b4683f6c7f45248d4d64056a24298c6281e0993356d7d1b4a1a962ef10d4a"
dependencies = [
 "proc-macro2",
 "quote",
 "syn",
 "synstructure",
]

[[package]]
name = "zerotrie"
version = "0.2.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "4ea269c3bd32f0a32c321907a2ae912ba6f4649bb0fc764a15627e99a7095a3f"
dependencies = [
 "displaydoc",
 "yoke",
 "zerofrom",
]

[[package]]
name = "zerovec"
version = "0.11.8"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "bb0464e17806c1d976d5cba29399c7f08e516e279e2ba493f63123b5fca67dd8"
dependencies = [
 "yoke",
 "zerofrom",
 "zerovec-derive",
]

[[package]]
name = "zerovec-derive"
version = "0.11.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "34df6fc39dbd26ddc9c10e6a2984476e13acce22e64e4487636ef494369225da"
dependencies = [
 "proc-macro2",
 "quote",
 "syn",
]
Cargo.toml
[package]
name = "sample-idna"
version = "1.0.0"
edition = "2021"
publish = false

[dependencies]
idna = "=1.1.0"

[[bin]]
name = "contract"
path = "test/contract.rs"
PROMPT.md
Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify idna in pkg:cargo/idna@1.1.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:cargo/idna@1.1.0
Demonstrate these symbols/APIs:
  - idna

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.
csx.json
{"case":{"caseId":"case:sha256:95635da4de91f08f53de6bbe54c5f048784ba982f8821ce6fc38b66a8347cb3b","contract":["domain_to_ascii converts internationalized domain names with Unicode characters to Punycode","domain_to_unicode decodes Punycode ASCII domains back to Unicode representations","domain_to_ascii_cow normalizes upper-case characters and enforces AsciiDenyList rules","domain_to_ascii_strict validates domain syntax under strict rules","punycode encodes Unicode strings to ASCII and decodes Punycode strings back to Unicode","Uts46 provides low-level IDNA processing with configurable AsciiDenyList and Hyphens policies"],"goal":"verify idna in pkg:cargo/idna@1.1.0","kind":"HOW","packages":["pkg:cargo/idna@1.1.0"],"schemaVersion":1,"symbols":["idna"]},"contractCommand":["cargo","run","--offline"],"environment":{"arch":"x64","distro":"alpine","ecosystem":"cargo","libc":"musl","os":"linux","packageManager":"cargo","schemaVersion":1},"license":"MIT-0","packages":["pkg:cargo/idna@1.1.0"],"schemaVersion":1,"subject":"pkg:cargo/idna@1.1.0","symbols":["idna"],"verifierAdapter":"cargo@1"}
spec.json
{
  "schemaVersion": 1,
  "goal": "verify idna in pkg:cargo/idna@1.1.0",
  "kind": "HOW",
  "packages": [
    "pkg:cargo/idna@1.1.0"
  ],
  "symbols": [
    "idna"
  ]
}
src/lib.rs
//! Clean-room verification sample for idna.

pub use idna::*;
test/contract.rs
use idna::punycode::{decode_to_string, encode_str};
use idna::uts46::{DnsLength, Hyphens, Uts46};
use idna::{domain_to_ascii, domain_to_ascii_cow, domain_to_ascii_strict, domain_to_unicode, AsciiDenyList};

fn main() {
    // 1. domain_to_ascii converts internationalized domain names with Unicode characters to Punycode
    let ascii_res = domain_to_ascii("xn--exmple-xta.com");
    assert_eq!(ascii_res.unwrap(), "xn--exmple-xta.com");

    let unicode_domain = "bücher.example";
    let encoded = domain_to_ascii(unicode_domain).expect("valid domain to ascii");
    assert_eq!(encoded, "xn--bcher-kva.example");

    // 2. domain_to_unicode decodes Punycode ASCII domains back to Unicode representations
    let (decoded, res) = domain_to_unicode("xn--bcher-kva.example");
    assert!(res.is_ok());
    assert_eq!(decoded, "bücher.example");

    // 3. domain_to_ascii_cow normalizes upper-case characters and enforces AsciiDenyList rules
    let cow_res = domain_to_ascii_cow(b"B\xC3\x9cCHER.EXAMPLE", AsciiDenyList::URL);
    assert!(cow_res.is_ok());
    assert_eq!(cow_res.unwrap(), "xn--bcher-kva.example");

    // 4. domain_to_ascii_strict validates domain syntax under strict rules
    let strict_ok = domain_to_ascii_strict("example.com");
    assert_eq!(strict_ok.unwrap(), "example.com");

    // 5. punycode encodes Unicode strings to ASCII and decodes Punycode strings back to Unicode
    let puny_encoded = encode_str("münchen").expect("encode munchen");
    assert_eq!(puny_encoded, "mnchen-3ya");
    let puny_decoded = decode_to_string(&puny_encoded).expect("decode munchen");
    assert_eq!(puny_decoded, "münchen");

    // 6. Uts46 provides low-level IDNA processing with configurable AsciiDenyList and Hyphens policies
    let uts46 = Uts46::new();
    let ascii_out = uts46.to_ascii(
        b"xn--bcher-kva.example",
        AsciiDenyList::EMPTY,
        Hyphens::Allow,
        DnsLength::Ignore,
    );
    assert!(ascii_out.is_ok());
    assert_eq!(ascii_out.unwrap(), "xn--bcher-kva.example");

    let (unicode_out, unicode_res) = uts46.to_unicode(
        b"xn--bcher-kva.example",
        AsciiDenyList::EMPTY,
        Hyphens::Allow,
    );
    assert!(unicode_res.is_ok());
    assert_eq!(unicode_out, "bücher.example");

    println!("All idna contract assertions passed successfully.");
}

原始种子者

匿名