SORA 3: Taira һәм Minamoto нигеҙендә төҙөлгән

SORA 3 - ҡушымтаға ҡараған асыҡ ҡулланыу трассаһы, ул Iroha 3 һәм SORA Nexus өҫтөндә төҙөлгән. Тәүҙә Taira өҫтөндә төҙөйһөгөҙ һәм репетициялайһығыҙ, һуңынан шул уҡ клиент формаһын Minamoto тип күсерегеҙ, тик айырым төп селтәр асҡыстары булған саҡта ғына, түләүҙәр өсөн реаль XOR һәм производство раҫлау.

Был дәреслек нисек конфигурировать күрһәтелә Iroha клиенты өсөн йәмәғәт SORA 3 селтәрҙәре:

• Taira һынау селтәре https://taira.sora.org
• Minamoto төп селтәрендә https://minamoto.sora.org

Ҡулланыу Taira Интеграция һынауҙары, трубка ярҙамында яҙылған канарҙар һәм ҡулланыу репетициялары өсөн. Minamoto тик етештереүгә әҙер төп селтәр эшмәкәрлеге өсөн генә. XOR:

• Taira асыҡ краннан тест селтәрен XOR ҡуллана.
• Minamoto реаль ҡулланыла XOR. Бер ниндәй ҙә Minamoto кран.

Төҙөүселәр юлы

Аҙым	Taira Тестнет	Minamoto Майннет
Сеть торошон уҡый башлағыҙ	Ключһыҙ һорау /status	Ключһыҙ һорау /status
Мәғлүмәттәр киңлеген һайлағыҙ	Ябай ҡулланыу universal, әгәр һеҙҙең ҡушымтаһы менән идара итеүсе юл кәрәкмәй	Бер үк мәғлүмәттәр киңлектәрен төп селтәрҙең хуплауын алғандан һуң ғына ҡулланығыҙ
Түләү активын алығыҙ .	Йәмәғәт Taira кранды ҡулланығыҙ	Финансландырылған Minamoto иҫәбенән йәки раҫланған казначейлыҡ ағымынан XOR алыу
Тест яҙған	Ҡулланығыҙ кран менән тәьмин ителгән һынау XOR	Тест инструмент ҡулланырға ярамай; яҙған аҡса реаль XOR
Дәртләндереү	Логика, күҙәтеү һәм ҡултамғалау менән эш итеүҙе дауам итегеҙ	Айырым асҡыстар, финанслау һәм иреккә сығарыу контролдәрен ҡулланығыҙ

Ғәмәли ағым:

1. Taira менән клиент төҙөү һәм йәмәғәт universal мәғлүмәт киңлеген ҡулланыу.
2. Ҡул ҡуйыусы ҡушымта өҫтәгеҙ һәм уны Taira кран менән түләгеҙ.
3. Ҡулланма логикаһын Taira менән ҡулланығыҙ, уңышһыҙлыҡтар киҫкен һәм күҙәтеләсәк тиклем.
4. Айырым Minamoto ҡултамғасы булдырыу, уны реаль XOR менән финанслау һәм шул уҡ иҫбатланған операцияларҙы ғына mainnet-ҡа күсереү.

1. Ниндәй маҡсаттар ҡуйырға теләгәнеңде аңла

Эсендәге SORA Nexus, мәғлүмәт киңлеге селтәр юлы һәм маршрутизация каталогының бер өлөшө булып тора. клиент яңы асыҡ мәғлүмәт киңлеген үҙгәртеп кенә барлыҡҡа килтермәй. client.toml. Клиент ҡоролмаһы ике эш итә:

1. клиентты уң Torii тамамлау нөктәһенә йүнәлтә
2. үҙ канон иҫәбенә домен һәм мәғлүмәттәр арауығы маршрутизация контексын һайлай

AccountId һәр ваҡыт каноник һәм доменһыҙ. client.toml-ҙағы [account].domain ҡиммәте маршрутлау һәм ҡушамат контексты бирә; ул иҫәп яҙмаһы идентификацияһының бер өлөшө булып китмәй. Күпселек ҡулланыуҙар өсөн асыҡ universal мәғлүмәт киңлеге менән башларға кәрәк. Домен контексы, мәҫәлән, domain.dataspace формаһын ҡуллана:

wonderland.universal

Әгәр һеҙгә яңы ойошма мәғлүмәттәр киңлеге кәрәк икән, уны ябай клиент иҫәбенән теркәү урынына каталог һәм маршрутлау тәҡдимен әҙерләгеҙ. Яңы мәғлүмәт киңлеген тәьмин итеү түбәндә ҡарағыҙ.

2. Халыҡ-ара Torii йомғаҡлау пунктын тикшерегеҙ

Ҡулланыусыны конфигурациялағансы, маҡсатлы һуңғы нөктәнең тере булыуын тикшерегеҙ.

Taira өсөн:

curl -fsS https://taira.sora.org/status \
  | jq '{peers, blocks, txs_approved, queue_size}'

Minamoto өсөн:

curl -fsS https://minamoto.sora.org/status \
  | jq '{peers, blocks, txs_approved, queue_size}'

Мәғлүмәт арауығы һәм йүнәлеш күренештәрен тикшерегеҙ:

curl -fsS https://taira.sora.org/status \
  | jq '.teu_lane_commit[] | {lane_id, alias, dataspace_id, dataspace_alias, visibility}'

Төп селтәр өсөн https://minamoto.sora.org/status менән шул уҡ команданы ҡулланығыҙ.

Агенттар өсөн Taira MCP

Taira шулай уҡ а Torii-урындағы Контекст протоколы моделе (MCP агенттар өсөн күпер. уны агент тере тест селтәре уҡый, скрипт диагностикаһы кәрәк саҡта ҡулланырға, йәки ғәҙәттәгесә төҙөмәйенсә ентекле тикшерелгән яҙыу репетициялары Torii Иң тәүҙә клиент.

Ҡуйыу	Ҡиммәт
MCP һуңғы пункт	https://taira.sora.org/v1/mcp
Сеть тамырҙары	https://taira.sora.org
Маҡсат	Taira тест селтәре уҡый һәм кран аҡсаһы менән яҙыу репетициялары
Производство эквиваленты	Был яҙманы Minamoto тип билдәләмәгеҙ, әгәр төп селтәрҙең MCP һуңғы пункты һәм сығарыу контроле асыҡтан-асыҡ раҫланмаһа.

Ҡул ҡуйыу материалын өҫтәр алдынан күпер метамәғлүмәттәре тикшерегеҙ:

curl -fsS https://taira.sora.org/v1/mcp \
  | jq '{protocolVersion, server: .serverInfo.name, tools: .capabilities.tools.count}'

URL серверын агент эшләү ваҡытында ҡулланыусыға урындағы MCP серверы итеп конфигурациялағыҙ. был документтар репоһына йәки ҡушымта репоһына агенттың MCP конфигурацияһын, API токендәрен, ебәрелгән автор башлыҡтарын, authority йәки private_key ҡиммәттәрен йөкләмәгеҙ.

Taira менән яҡшы эшләүсе агенттарҙың тиҙләтеү ҡағиҙәләре:

• MCP серверҙан инструменттар табыу, уларҙы шылтыратыр алдынан; әгәр сервер listChanged тураһында хәбәр итһә, ҡабаттан табырға.
• iroha. инструменттарын сымал torii. инструменттарға ҡарағанда өҫтөнөрәк ҡуя.
• Уҡыу менән генә башлағыҙ: яҙмаларҙы тәҡдим иткәнгә тиклем статусын, иҫәптәрҙе, активтарҙы, ҡушаматтарҙы, блоктарҙы, идара итеү торошон һәм транзакция торошон тикшерегеҙ.
• Тере тест селтәре мутацияларына тиклем кеше тарафынан асыҡтан-асыҡ күрһәтмәләр талап ителә. Алдан имзаланған транзакция конверттары өсөн iroha.transactions.submit_and_wait ҡулланығыҙ, шуға күрә агент һөҙөмтәне тапшырыу урынына көтә.
• Транзакция хештарын, һуңғы статусты һәм серверҙың раҫлау хаталарын агент яуаптарында йомғаҡларға.

Агенттар менән эшләү процесы

Iroha клиенттары, транзакция төҙөүселәре, диагностика скрипттары һәм тест-нет эшләтеү китаптары өсөн агенттарҙы үҫтереүҙә ярҙамсы итеп ҡулланығыҙ. ул кодты тикшерә ала, Taira хәлен уҡый ала, үҙгәрештәр тәҡдим итә һәм урындағы һынауҙар үткәрә ала, әммә кеше теүәл операцияны раҫламайынса тере селтәрҙе мутацияларға тейеш түгел.

Ғәмәли эш процесы булып тора:

1. SDK кодын, CLI командаһын йәки MCP инструмент схемаһын яҙыр алдынан агенттан тикшерергә һорағыҙ.
2. Башта агентҡа иң бәләкәй клиент юлына яҙырға ҡуш: статус тикшереүе, иҫәп-хисап эҙләү, псевдонимы менән хәл итеү, йәки баланс эҙләү.
3. Транзакция төҙөү кодын өҫтәү бары тик уҡырға ғына саҡырыуҙар Taira менән эшләгәндән һуң ғына.
4. Тормош селтәре һынауҙарын һайлағыҙ, мәҫәлән TAIRA_LIVE=1 артында тотоноғоҙ, шуға күрә ғәҙәти берәмектәге һынау барышында тест селтәренең аҡсаһы бер ҡасан да сарыф ителмәй йәки селтәрҙең булыуына бәйле.
5. Агенттан ниндәй ҙә булһа транзакцияны тапшыр алдынан селтәрҙең тамыр, сылбыр, хакимиәт иҫәбенә, инструкцияларға йомғаҡ яһау, түләү активтары һәм көтөлә торған дәүләт үҙгәрештәрен хәбәр итеүҙе талап итергә.
6. CI йәки төп селтәрҙәге эш ағымдарына күсерер алдынан, йәшерен эшкәртеү, ҡабаттан һынау тәртибе, idempotency һәм кире ҡағыу менән шөғөлләнеү өсөн булдырылған кодты ҡарағыҙ.

Үҫеш өсөн файҙалы уҡыу ғына MCP инструменттар иҫәбенең активтарын эҙләү, псевдонимдар менән хәл итеү, блоктарҙы эҙләү, операцияларҙы эҙләү, транзакция исемлектәрен һәм үткәргес ҡаҙаныштарын тикшереүҙе үҙ эсенә ала.

Use Taira MCP as a read-only inspector while developing this Iroha feature.
Inspect available iroha.* tools, verify the target account and asset state,
then update the client code. Do not submit transactions unless I explicitly
say "submit this transaction".

Транзакциялар агенттар аша эш ағымы

MCP күпере ҡул ҡуйылған Iroha транзакцияны тапшыра ала, әммә ул ғәҙәти транзакция талаптарын алып ташлай алмай. Транзакцияға дөрөҫ хоҡуҡ, рөхсәт, түләүҙәр финанслау, ID сылбыр, метамәғлүмәт һәм ҡултамға кәрәк.

Iroha операциялары өсөн, транзакция конвертын башта SDK йәки CLI менән төҙөү һәм имзалау, һуңынан агентҡа бары тик body_base64 тип кодланған каноник ҡул ҡуйылған транзакция байттары ғына бирегеҙ. Агент конвертты iroha.transactions.submit_and_wait менән тапшыра ала, йәки iroha.transactions.submit һәм iroha.transactions.wait менән һорау алыуҙы бирә ала.

Әгәр агент транзакцияны төҙөргә теләй икән, уны локаль кодҡа йүнәлтегеҙ, ул ҡулланыусының йүгереү ваҡыты мөхитендәге серҙәрҙе, клавиатураны, аппарат имзалаусыһын йә тестнет конфигурация файлын иҫәпкә алмай. Агент бер ҡасан да төп материалды "Маркдаун"ға, фиксаторҙарға, журналдарына йә йөкләмәләргә яҙырға тейеш түгел.

Транзакцияны тапшыр алдынан, агентҡа ҡыҫҡа транзакция планын әҙерләргә ҡуш:

• network: Taira тест селтәре тамырҙары һәм сылбырҙары ID
• authority: яҙыусы һәм түләүселәр иҫәбенә
• instructions: реестр, банкротлыҡ, яндырыу, күсереү, метамәғлүмәт, рөхсәт йәки килешеү саҡырыуы йомғаҡтары
• fee asset: Taira өсөн түләнә торған актив
• preflight reads: иҫәб, активтар балансы, рөхсәттәре, исем-шәрифтәре йәки блок тикшереүҙәре инде башҡарылған
• expected result: раҫланғандан һуң күренеп торорға тейешле хәл
• idempotency: әгәр шул уҡ үтенесе ҡабаттан тикшерелһә, нимә буласаҡ?

Ҡабул ителгәндән һуң, агентҡа терминал статусын көтөп торорға мәжбүр итегеҙ, һуңынан хәл үҙгәрешен уҡыу һорауы менән тикшерегеҙ. Яҡшы тамамлау отчеты:

• транзакция хэшигы
• Committed, Applied, Rejected йәки Expired кеүек терминал статусы.
• Блок йәки эксперименталь деталдәр, әгәр улар бар булһа
• тикшеренеүҙәр һөҙөмтәләре
• кире ҡағыу хәбәрен һәм уңышһыҙлыҡ рөхсәт, түләүҙәр, валидация, иҫкергән дәүләт йәки һуңғы пункттың булыуы кеүек күренәме

Миҫал һаҡланған тиҙ арала:

Prepare a Taira transaction plan, but do not submit yet. Use MCP reads to
verify the authority account, fee balance, target asset or alias, and current
transaction status if a hash already exists. Show the exact instructions and
expected post-state. Wait for my explicit "submit" message before calling
iroha.transactions.submit_and_wait.

Ҡул ҡуйылған конверт әҙерләнгәндә:

Submit this pre-signed Taira transaction envelope with
iroha.transactions.submit_and_wait. Use the provided body_base64 only; do not
ask for private keys. Wait for a terminal status, then verify the resulting
state with read-only iroha.* tools and report the hash, status, and
verification result.

Taira MCP-ны асыҡ һынау селтәре контроле өҫкө йөҙө итеп ҡарағыҙ. Taira асҡыстары, тест селтәре XOR, кран иҫәптәре һәм канар ҡултамғалары бер тапҡыр ҡулланыла һәм улар Minamoto асҡыстарынан һәм производство сығарыу эш ағымдарынан айырылып торорға тейеш.

Хәҙер һынап ҡарағыҙ

Был миҫалдар, әгәр билдәләнмәһә, уҡырға ғына мөмкин. Улар асҡыстар тыуҙырғанға тиклем эшләй һәм ике йәмәғәт селтәренә лә ҡаршы хәрәкәт итеү хәүефһеҙ.

Taira тест селтәрен һәм Minamoto төп селтәрҙең һаулығын сағыштырығыҙ:

for network in taira minamoto; do
  root="https://$network.sora.org"
  printf '\n%s\n' "$network"
  curl -fsS "$root/status" \
    | jq '{blocks, txs_approved, txs_rejected, queue_size, peers}'
done

Taira асыҡ мәғлүмәттәр киңлектәре юлдары исемлеген яҙығыҙ:

curl -fsS https://taira.sora.org/status \
  | jq -r '.teu_lane_commit[]
    | [.lane_id, .alias, .dataspace_alias, .visibility, .storage_profile, .block_height]
    | @tsv'

Төп селтәр күренеше кәрәк саҡта Minamoto менән шул уҡ команданы үтәгеҙ:

curl -fsS https://minamoto.sora.org/status \
  | jq -r '.teu_lane_commit[]
    | [.lane_id, .alias, .dataspace_alias, .visibility, .storage_profile, .block_height]
    | @tsv'

Дашборд, бот йәки урынлаштырыу тикшереүе өсөн бәләкәй Node.js торошо сондаһын төҙөй:

node --input-type=module <<'EOF'
const roots = {
  taira: 'https://taira.sora.org',
  minamoto: 'https://minamoto.sora.org',
};

for (const [name, root] of Object.entries(roots)) {
  const status = await fetch(`${root}/status`).then((res) => res.json());
  const publicSpaces = status.teu_lane_commit
    .filter((lane) => lane.visibility === 'public')
    .map((lane) => `${lane.dataspace_alias}:${lane.block_height}`)
    .join(', ');

  console.log(
    `${name}: ${status.blocks} blocks, ${status.queue_size} queued, public spaces ${publicSpaces}`,
  );
}
EOF

Тәүге яҙыу яғында уйынсыҡ Taira кран claim булырға тейеш. Ул тест селтәрен ҡуллана XOR һәм бер ҡасан да Minamoto күрһәтергә тейеш түгел.

3. Taira клиент конфигурацияһын булдырыу.

Әгәр һеҙҙә юҡ икән, асҡыс парын булдырыу:

kagami keys --algorithm ed25519 --json

taira.client.toml булдырыу:

chain = "fc56984b-2be7-431d-840e-21514d1883f0"
torii_url = "https://taira.sora.org/"

[account]
domain = "wonderland.universal"
profile = "taira"
public_key = "<ED25519_PUBLIC_KEY_HEX>"
private_key = "<ED25519_PRIVATE_KEY_HEX>"

[transaction]
time_to_live_ms = 100000
status_timeout_ms = 15000
nonce = false

Иң юғары кимәлдә chain тап шул Taira транзакциялар сылбыры ID. Ҡоролтай [account].profile = "taira" көйләү үҙ аллы һайлай Taira I105 Сылбырлы дискриминатор. ID иҫәбенең профилен һайламай.

Уҡыу өсөн генә тикшерегеҙ:

iroha --config ./taira.client.toml --output-format text ops sumeragi status

Яҙыу һынауҙарына тиклем асыҡ диагностикалар Taira үтәү:

iroha taira doctor --public-root https://taira.sora.org --json

Taira аккаунтын түләп яҙыуҙан алда кран аша финанслау. Тура кран ағымы Get Testnet XOR на Taira.

Кран өсөн дәғүә ҡабул ителгәндән һуң һәм иҫәпкә аҡса бүленгәндән һуң, Taira канарияһы факультатив төтөн һынау булып тора:

iroha --config ./taira.client.toml taira write-canary \
  --public-root https://taira.sora.org \
  --write-config ./taira.canary.client.toml \
  --json

--write-config күрһәтелгәс, канар ҡултамғалы пинг тапшыра, раҫлауҙы көтә һәм йүгереү ваҡыты имзалаусының конфигурацияһын яҙа. Taira асыҡ тест селтәре булып тора, шуға күрә сираттың туйыныуы ҡултамғаланған пингтың крана үҙе эшләгәндә лә уңышҡа өлгәшеүе мөмкин. Әгәр taira doctor ҡәнәғәтләндерелгән сират тураһында хәбәр итә йәки канарий кире ҡайтарһа PRTRY:NEXUS_FEE_ADMISSION_REJECTED, уны клиент конфигурацияһы хатаһы тип иҫәпләгәнгә тиклем көтөп һәм яңынан һынап ҡарағыҙ.

Күҙәтеүһеҙ тәмәке һынауҙары өсөн, канарийҙы сикләнгән ҡабаттан һынау циклына төрөп ҡуйығыҙ:

ok=false
for attempt in 1 2 3 4 5; do
  iroha --config ./taira.client.toml taira write-canary \
    --public-root https://taira.sora.org \
    --write-config ./taira.canary.client.toml \
    --json && ok=true && break

  sleep 60
done

test "$ok" = true

iroha taira doctor етди уңышһыҙлыҡтар күрһәткән осраҡта ҡабаттан һынауҙы туҡтатығыҙ. сираттың туйыныуы һәм түләү ҡабул итеүҙән баш тартыу - йәмәғәт тест селтәре шарттары; DNS, TLS йәки status = "fail" диагностикалары юҡ.

SORA Nexus хисапты булдырыу ID

А SORA Nexus иҫәбенә ID - каноник I105 адресы иҫәп-хисап асыҡ асҡысынан һәм маҡсатлы селтәр префиксинан алынған. [account].domain клиенттағы ҡиммәт TOML. Бер үк асыҡ асҡыс кодтары төрлө IDs тураһында Taira һәм Minamoto, һәм етештереү ҡулланыусылары өсөн айырым асҡыс пар Minamoto.

Бухгалтер иҫәбенә контроллек итеүсе Ed25519 төймәһе парын булдырыу йәки йөкләү:

kagami keys --algorithm ed25519 --json

Йәмәғәт асҡысын Taira иҫәбенә ID күсерергә:

iroha tools address convert --profile taira <ED25519_PUBLIC_KEY_HEX>

Minamoto асыҡ асҡысын төп селтәр префиксы менән үҙгәртергә:

iroha tools address convert --profile minamoto <ED25519_PUBLIC_KEY_HEX>

Һөҙөмтәлә алынған иҫәбен ҡулланығыҙ ID ҡайҙа Nexus API йәки CLI командование канонический отчет һорай ID, мәҫәлән, Taira кран account_id, баланс һорауҙары, ҡаты иҫәп-хисап баҫыуҙар, йәки псевдонимы бәйләнештәр. тура килә шәхси асҡысын клиент конфигурацияһында һаҡларға, һәм шул уҡ йәмәғәт селтәрен һайларға [account].profile = "taira" йәки [account].profile = "minamoto".

ID генерацияһы үҙенән-үҙе финансланған сылбыр иҫәбенә барлыҡҡа килмәй. Taira өҫтөндә, кран булдыра һәм тестнет яҙған өсөн иҫәпте финанслай ала. Minamoto өҫтөндә, раҫланған төп селтәрҙе ҡушыу йәки ҡаҙна ағымдарын ҡулланыу .

Ключтарҙы һаҡлау һәм уларҙы һаҡлап ҡалыу

Иҫәпкә ID һәм асыҡ асҡыс бүленә ала. Бер-береһенә тап килгән шәхси асҡыс, пароль, орлоҡ һәм кире ҡайтарыу материалдары йәшерен һаҡланырға тейеш.

SORA Nexus иҫәбе өсөн ошо алымдарҙы ҡулланығыҙ:

• Хосуси асҡыстарҙы шифрлы пароль менеджерында, аппарат ярҙамында тәьмин ителгән клавиатура магазинында йәки махсус ҡултамғалау хеҙмәтендә һаҡларға. Ключтарҙы сығанаҡ контроллерына йөкләмәгеҙ йәки продукция ключтарын тышлыҡ тарихында, журналдарҙа, чатта, билеттарҙа йә шифрланмаған резервтағы күсермәләрҙә ҡалдырығыҙ.
• Һәр келәт йәки етештереү имзалаусы өсөн үҙенсәлекле юғары энтропиялы пароль фразаһын ҡулланығыҙ. Паролдәрҙе шифрланған шәхси асҡыс менән бер үк файлда йәки резерв тупланмаһында түгел, ә пароль менеджерында йә бүленгән һаҡлау процесында һаҡлау.
• Taira һәм Minamoto асҡыстарын айырым һаҡлағыҙ. Taira асҡыстарын бер тапҡыр ҡулланылған һынау селтәре материалы итеп, Minamoto асҡыстарын етештереү фонды органы итеп ҡарағыҙ.
• Шәхси асҡыс, йәмәғәт асҡысы, иҫәбенә ID, иҫәб профиле, һәм ҡул ҡуйған кешене тергеҙеү өсөн кәрәк булған бөтә иҫәп-хисапҡа ҡайтарыу йәки һаҡланыу ҡағыҙҙары. Шелтәр контексы булмаған шәхси асҡысты тергеҙеү ваҡытында дөрөҫ ҡулланыу еңел.
• Производство имзалаусылары өсөн кәмендә бер шифрланған офлайн резерв коды һәм географик яҡтан айырым бер шифрлы резерв коды һаҡлағыҙ. Өҫтәмә күсермәгә бәйле тиклем бәләкәй генә уҡырға ғына операция менән тергеҙеү һынау.
• Әгәр шәхси асҡыс, пароль фразаһы, резерв медиаһы йәки ҡултамғалау хостинг асыҡланған булһа, ҡултамғаһын әйләндереү йәки алмаштырыу.

Тулыраҡ мәғлүмәт өсөн ҡарағыҙ Сохранение криптографических ключей һәм Пароль хәүефһеҙлеге .

4. Тестнетҡа XOR шылтыратып, Taira

Туранан-тура йәмәғәт краны менән файҙаланығыҙ.

1. Ҡулланыусыны булдырыу йәки йөкләү һәм уның Taira каноник иҫәбенә иҫәпләү ID.
2. Хәҙерге трубканы алып килегеҙ.
3. Әгәр difficulty_bits 0-дан ҙурыраҡ икән, табышманы хәл итегеҙ.
4. Кран өсөн дәғүә белдерегеҙ.
5. Түләү өсөн хаттар ебәрер алдынан иҫәбенең йәки активтың балансының күренеп китеүен көтөгөҙ.

Йәмәғәт серле асҡысын Taira I105 иҫәбенә ID Һыуыҡтан көтөлә:

iroha tools address convert --profile taira <ED25519_PUBLIC_KEY_HEX>

Төшөнсәһен алып кил:

curl -fsS https://taira.sora.org/v1/accounts/faucet/puzzle | jq .

Грант - асыҡ тест селтәре сервисы. Әгәр табышмак йәки талап йомғаҡ нөктәһе 502, ваҡыт үтеү, йәки башҡа шлюз кимәлендәге хатаны кире ҡайтарһа, көт һәм үҙ асҡыстарығыҙҙы йәки клиент конфигурацияһын үҙгәртер алдынан тағы ла тырышығыҙ.

Яуап ошондай формаға эйә:

{
  "algorithm": "scrypt-leading-zero-bits-v1",
  "difficulty_bits": 8,
  "anchor_height": 741,
  "anchor_block_hash_hex": "05d2...",
  "challenge_salt_hex": null,
  "scrypt_log_n": 13,
  "scrypt_r": 8,
  "scrypt_p": 1,
  "max_anchor_age_blocks": 6
}

Әгәр difficulty_bits - 0 булһа, бары тик ID хисабын ғына тапшырырға кәрәк:

curl -fsS https://taira.sora.org/v1/accounts/faucet \
  -H 'content-type: application/json' \
  -d '{"account_id":"<TAIRA_I105_ACCOUNT_ID>"}'

Әгәр difficulty_bits 0-тан ҙурыраҡ булһа, табышмакты хәл итегеҙ һәм якорь бейеклеген өҫтәп nonce иҫәбенә индерегеҙ:

curl -fsS https://taira.sora.org/v1/accounts/faucet \
  -H 'content-type: application/json' \
  -d '{
    "account_id": "<TAIRA_I105_ACCOUNT_ID>",
    "pow_anchor_height": 741,
    "pow_nonce_hex": "<NONCE_HEX>"
  }'

Алгоритмы:

1. Һынауҙы SHA-256 тип төҙөргә:
   • iroha:accounts:faucet:pow:v2 байттары
   • UTF-8 иҫәбенә ID
   • anchor_height ҙур эндиан u64
   • anchor_block_hash_hex байтҡа декодланған
   • challenge_salt_hex байт рәүешендә декодланған, әгәр улар бар булһа
2. u64 nonces кодланған ҙур эндиан 8-байт ҡиммәттәрен һынап ҡарарға.
3. Һәр nonce өсөн scrypt менән эшләгеҙ:
   • пароль: 8-байт нонс
   • тоҙ: 32 байтлыҡ проблема
   • N = 2^scrypt_log_n
   • r = scrypt_r
   • p = scrypt_p
   • сығарыу оҙонлоғо: 32 байт
4. Еңеүсе нонс - тәүҙә difficulty_bits нуль биттарҙы алып барыусы беренсе дигерж.

Ҡапҡаға яуап финансланған активты һәм сираттағы транзакция хешын үҙ эсенә ала:

{
  "account_id": "<TAIRA_I105_ACCOUNT_ID>",
  "asset_definition_id": "6TEAJqbb8oEPmLncoNiMRbLEK6tw",
  "asset_id": "...",
  "amount": "25000",
  "tx_hash_hex": "...",
  "status": "QUEUED"
}

Хәҙерге ваҡытта HTTP 202 Accepted менән яуап ҡайтарыла. Юғарыла күрһәтелгән актив билдәләмәһе ID - йәмәғәт краны тарафынан финансланған Taira түләүле актив. tx_hash_hex һәм status: "QUEUED" кире ҡайтарғандан һуң, кранит үтенесе ҡабул ителгән.

Һуңынан үҙ түләүҙәр менән килешеүҙәрҙе тапшырыуҙан алда финансланған актив буйынса һорау алыу үткәрегеҙ:

iroha --config ./taira.client.toml ledger asset get \
  --definition 6TEAJqbb8oEPmLncoNiMRbLEK6tw \
  --account <TAIRA_I105_ACCOUNT_ID>

Әгәр faucet талап ҡабул ителгән, әммә иҫәбенә йәки актив әле күренеп булмай икән, транзакция һаман да асыҡ testnet сират эшкәртеү артында тора. көт һәм ҡабаттан уҡырға тырышығыҙ ебәреү яҙған тиклем.

Төҙөлөшкә әҙер туранан-тура API тикшереү өсөн, ошоны taira_faucet_claim.py тип һаҡлағыҙ һәм Taira I105 иҫәбенә ID күсертегеҙ:

#!/usr/bin/env python3
import hashlib
import json
import sys
import urllib.request


def has_leading_zero_bits(digest: bytes, bits: int) -> bool:
    full, rem = divmod(bits, 8)
    if digest[:full] != b"\0" * full:
        return False
    return rem == 0 or digest[full] >> (8 - rem) == 0


root = "https://taira.sora.org"
account_id = sys.argv[1]

with urllib.request.urlopen(f"{root}/v1/accounts/faucet/puzzle") as res:
    puzzle = json.load(res)

claim = {"account_id": account_id}
difficulty = int(puzzle["difficulty_bits"])

if difficulty > 0:
    challenge = hashlib.sha256()
    challenge.update(b"iroha:accounts:faucet:pow:v2")
    challenge.update(account_id.encode())
    challenge.update(int(puzzle["anchor_height"]).to_bytes(8, "big"))
    challenge.update(bytes.fromhex(puzzle["anchor_block_hash_hex"]))
    if puzzle.get("challenge_salt_hex"):
        challenge.update(bytes.fromhex(puzzle["challenge_salt_hex"]))

    n = 1 << int(puzzle["scrypt_log_n"])
    r = int(puzzle["scrypt_r"])
    p = int(puzzle["scrypt_p"])
    salt = challenge.digest()

    for nonce in range(1_000_000):
        nonce_bytes = nonce.to_bytes(8, "big")
        digest = hashlib.scrypt(nonce_bytes, salt=salt, n=n, r=r, p=p, dklen=32)
        if has_leading_zero_bits(digest, difficulty):
            claim["pow_anchor_height"] = puzzle["anchor_height"]
            claim["pow_nonce_hex"] = nonce_bytes.hex()
            break
    else:
        raise SystemExit("faucet nonce not found")

request = urllib.request.Request(
    f"{root}/v1/accounts/faucet",
    data=json.dumps(claim).encode(),
    headers={"content-type": "application/json"},
    method="POST",
)

with urllib.request.urlopen(request) as res:
    print(json.dumps(json.load(res), indent=2))

Taira тест селтәре фонды өсөн генә тәғәйенләнгән. Minamoto ағымдарҙа тест селтәрен, XOR кран иҫәптәрен йәки Taira канарий ҡултамғаларын ҡулланырға ярамай.

5. Minamoto клиент конфигурацияһын булдырыу.

Minamoto өсөн айырым асҡыс парын ҡулланығыҙ. Taira асҡыстарын төп селтәр өсөн ҡабатланмағыҙ.

minamoto.client.toml булдырыу:

chain = "00000000-0000-0000-0000-000000000753"
torii_url = "https://minamoto.sora.org/"

[account]
domain = "wonderland.universal"
profile = "minamoto"
public_key = "<ED25519_PUBLIC_KEY_HEX>"
private_key = "<ED25519_PRIVATE_KEY_HEX>"

[transaction]
time_to_live_ms = 100000
status_timeout_ms = 15000
nonce = false

Иң юғары кимәлдә chain ағым Nexus төп селтәр селтәре ID. [account].profile = "minamoto" һайлай Minamoto I105 Сылбыр айырмасыһы; һуңғы пункттың хужа исеме һәм сылбыр ID уны йәшерен рәүештә һайламағыҙ.

Minamoto асыҡ асҡысын уның I105 каноник иҫәбенә ID префиксы менән үҙгәртергә:

iroha tools address convert --profile minamoto <ED25519_PUBLIC_KEY_HEX>

Иҫәпкә аҡса тупланғанға тиклем һәм төп селтәрҙе ҡушыу йәки идара итеү ағымы аша финансланғанға тиклем уҡый торған яҡтан ғына тикшереүҙәр үткәреү:

iroha --config ./minamoto.client.toml --output-format text ops sumeragi status

Taira кранды йәки яҙыу-канар ярҙамсыһын Minamoto менән ҡуймағыҙ.

6. Фонд а Minamoto Бухгалтер иҫәбенә XOR

Minamoto түләүҙәр етештереү менән түләнә XOR, һәм Minamoto-ның йәмәғәт краны юҡ. Конфигурацияланған иҫәбенә раҫланған төп селтәрҙе ҡушыу йәки казначейлыҡ күсереү аша аҡса түләгеҙ, йәки ғәмәлдәге финансланған Minamoto иҫәбенән XOR алығыҙ.

ID һәм финанслауҙы уҡыу өсөн генә тикшереүҙәр менән тикшерегеҙ, яҙма тапшырыуҙан алда. Minamoto XOR-ны производство средстволары итеп ҡарағыҙ: башта шул уҡ операцияны Taira буйынса күнегегеҙ, айырым етештереү асҡыстарын һаҡлағыҙ һәм төп селтәр транзакцияһын ҡабаттан ҡуйып була тип иҫәпләмәгеҙ.

Taira XOR Minamoto түләүҙәрен түләй алмай.Testnet балансы һәм кран өсөн дәғүәҙәр Minamoto гә күсерелмәй.

7. Бар булған мәғлүмәттәр арауығында эш итеү

Мәғлүмәт киңлеге эсендә йәшәүсе иҫәплек объекттары өсөн тулыһынса квалификациялы домен исемдәрен ҡулланығыҙ. Мәҫәлән, йәмәғәт мәғлүмәт киңлегендә проект домены ҡулланырға тейеш:

apps.universal

Иҫәпкә тейешле рөхсәттәре булғандан һуң, домен өсөн йәшерен булмаған AliasSetupPlanRequestV1 ниәтен булдырығыҙ һәм декларатив планерҙы ҡулланығыҙ:

iroha --config ./taira.client.toml \
  app alias setup plan \
  --intent-file ./taira-apps-domain.intent.json \
  --plan-file ./taira-apps-domain.plan.json

iroha --config ./taira.client.toml \
  --metadata ./taira.tx-metadata.json \
  app alias setup apply --plan-file ./taira-apps-domain.plan.json

Minamoto өсөн айырым төп селтәрҙең ниәте һәм планын булдырыу һәм раҫлау. Пландар уларҙың сылбыр, власть, йәшәү дәүләте якорьына һәм ваҡытына бәйле, шуға күрә Taira планы тәҡдим ителә алмай йәки ҡабатлана алмай:

iroha --config ./minamoto.client.toml \
  app alias setup plan \
  --intent-file ./minamoto-apps-domain.intent.json \
  --plan-file ./minamoto-apps-domain.plan.json

iroha --config ./minamoto.client.toml \
  app alias setup apply --plan-file ./minamoto-apps-domain.plan.json

Хисап исемдәре шул уҡ мәғлүмәттәр киңлеге суффиксын ҡуллана:

alice@apps.universal
alice@universal

Ҡаты иҫәп-хисап ҡырҙарында һаман да каноник ҡулланыла I105 иҫәбенә IDs. Алфавиттарҙы кеше уҡый алған бәйләнештәр тип иҫәпләгеҙ, улар ҡануниәттең ҡағиҙәләренә тура килә IDs.

8. Яңы мәғлүмәт туплау урыны булдырыу

Яңы мәғлүмәт киңлеге - оператор һәм идара итеү үҙгәреше. асыҡ Torii һуңғы нөктә трафикты конфигурацияланған мәғлүмәт киңлектәренә йүнәлтә ала, әммә ул билдәле булмаған мәғлүмәттәр киңлектәре атамаларын кире ҡағасаҡ.

Үҙгәреште әҙерләгәнсе, хәҙерге тере каталогты ҡулға алығыҙ:

curl -fsS https://taira.sora.org/status \
  | jq '.teu_lane_commit[] | {lane_id, alias, dataspace_id, dataspace_alias, visibility}'

Оператор иҫәбенә, шулай уҡ трасса манифест торошо тикшерергә:

iroha --config ./operator.client.toml app nexus lane-report --summary

Юл һыҙығы булмаһа , яңы исемде пропагандаламағыҙ . ID, мәғлүмәттәр арауығы ID, Валидатор йыйылмаһы, хаталар толеранцияһы, манифест, маршрутлау ҡағиҙәләре һәм оператив хужа бергә тикшерелде. Кәрәкле рөхсәттәре менән ғәҙәти ҡулланыусы иҫәбенә домен һәм уның SNS ғәмәлдәге мәғлүмәти майҙансыҡтарҙы псевдопланер аша ҡуртымға алыу; ул яңы асыҡ мәғлүмәт киңлектәрен хәүефһеҙ рәүештә өҫтәй алмай.

Шәхси йәки ойошма мәғлүмәттәр киңлектәре өсөн каталог үҙгәрештәрен әҙерләргә:

• уникаль мәғлүмәттәр киңлеге һәм һанлы id
• бәйләнешле полосаға инеү йәки ғәмәлдәге полосаға тәғәйенләү
• мәғлүмәттәр киңлеге fault_tolerance
• унда урынлашырға тейешле күрһәтмәләр йәки иҫәп биләмәләре өсөн маршрутлау ҡағиҙәләре
• UAID мөмкинлектәрен асыҡлаған осраҡта, Space Directory manifest йәки эквивалентлы rollout иҫбатламаһы
• Validator, compliance, settlement һәм monitoring сәйәсәте өсөн идара итеүҙе раҫлау

Тикшереүгә мөмкин булған конфигурация фрагменты ошондай күренә:

[[nexus.lane_catalog]]
index = 5
alias = "payments"
description = "Payments lane"
dataspace = "payments"
visibility = "public"
metadata = {}

[[nexus.dataspace_catalog]]
alias = "payments"
id = 20
description = "Payments dataspace"
fault_tolerance = 1

[[nexus.routing_policy.rules]]
lane = 5
dataspace = "payments"
[nexus.routing_policy.rules.matcher]
account_prefix = "payments."
description = "Route payments domains to the payments dataspace"

Операторҙың ҡабул итеүендә түбәндәге ҡапҡалар булырға тейеш:

• irohad --sora --config <config.toml> --trace-config хәл ителгән узел конфигурацияһын тапшыра
• генерацияланған йәки тикшерелгән манифест хеш һәм ҡултамғалар менән архивланған
• Тәмәке һынауҙары Taira өҫтөндә үтә, ә Minamoto акцияһына тиклем.
• /status үҙгәрештән һуң каталогы планлаштырылған трассаны һәм мәғлүмәт киңлеген күрһәтә.
• iroha app nexus lane-report --summary кәрәкле манифестарҙың юҡ булыуын хәбәр итмәй

curl -fsS https://taira.sora.org/status \
  | jq '.teu_lane_commit[] | select(.dataspace_alias == "payments")'

Taira урынлаштырыу, төтөн һынауҙар, мониторинг һәм идара итеү иҫбатлауҙары тамамланғандан һуң ғына шул уҡ мәғлүмәттәр киңлеген Minamoto ҡа еткерергә.

Төрлө биттәр

• Iroha 3 ҡуйыу
• Iroha 3 аша хәрәкәт итеү CLI
• Шәхси мәғлүмәттәр базаһы өсөн спонсорлыҡ түләүҙәре
• Torii сикләү пункттары
• Башланмыш шиғыры