Files
pezkuwi-sdk/bizinikiwi/pezframe/transaction-storage
pezkuwichain 65b7f5e640 fix: Resolve cargo clippy errors and add CI workflow plan
## Changes

### Clippy Fixes
- Fixed deprecated `cargo_bin` usage in 27 test files (added #![allow(deprecated)])
- Fixed uninlined_format_args in zombienet-sdk-tests
- Fixed subxt API changes in revive/rpc/tests.rs (fetch signature, StorageValue)
- Fixed dead_code warnings in validator-pool and identity-kyc mocks
- Fixed field name `i` -> `_i` in tasks example

### CI Infrastructure
- Added .claude/WORKFLOW_PLAN.md for tracking CI fix progress
- Updated lychee.toml and taplo.toml configs

### Files Modified
- 27 test files with deprecated cargo_bin fix
- bizinikiwi/pezframe/revive/rpc/src/tests.rs (subxt API)
- pezkuwi/pezpallets/validator-pool/src/{mock,tests}.rs
- pezcumulus/teyrchains/pezpallets/identity-kyc/src/mock.rs
- bizinikiwi/pezframe/examples/tasks/src/tests.rs

## Status
- cargo clippy: PASSING
- Next: cargo fmt, zepter, workspace checks
2025-12-23 09:37:11 +03:00
..

Transaction Storage Pezpallet

Indexes transactions and manages storage proofs.

Allows storing arbitrary data on the chain. Data is automatically removed after StoragePeriod blocks, unless the storage is renewed. Validators must submit proof of storing a random chunk of data for block N - StoragePeriod when producing block N.

Running a chain

The following describes how to set up a new storage chain.

Start with generating a chain spec.

cargo run --release -- build-spec --chain=local > sc_init.json

Edit the json chain spec file to customise the chain. The storage chain genesis params are configured in the transactionStorage section. Note that storagePeriod is specified in blocks and changing it also requires code changes at the moment.

Build a raw spec from the init spec.

cargo run --release build-spec --chain=sc_init.json --raw > sc.json

Run a few validator nodes.

cargo run --release -- --chain=sc.json -d /tmp/alice --storage-chain --keep-blocks=100800 --ipfs-server --validator --alice
cargo run --release -- --chain=sc.json -d /tmp/bob --storage-chain --keep-blocks=100800 --ipfs-server --validator --bob

--storage-chain enables transaction indexing. --keep-blocks=100800 enables block pruning. The value here should be greater or equal than the storage period. --ipfs-server enables serving stored content over IPFS.

Once the network is started, any other joining nodes need to sync with --sync=fast. Regular sync will fail because block pruning removes old blocks. The chain does not keep full block history.

cargo run --release -- --chain=sc.json -d /tmp/charlie --storage-chain --keep-blocks=100800 --ipfs-server --validator --charlie --sync=fast

Making transactions

To store data use the transactionStorage.store extrinsic. And IPFS CID can be generated from the Blake2-256 hash of the data.

const util_crypto = require('@pezkuwi/util-crypto');
const keyring_api = require('@pezkuwi/keyring');
const pezkuwi_api = require('@pezkuwi/api');
const fs = require('fs');
const multihash = require('multihashes');
const CID = require('cids')

const wsProvider = new pezkuwi_api.WsProvider();
const api = await pezkuwi_api.ApiPromise.create({ provider: wsProvider });

const keyring = new keyring_api.Keyring({ type: "sr25519" });
const alice = keyring.addFromUri("//Alice");

const file = fs.readFileSync('cute_kitten.jpeg');
const hash = util_crypto.blake2AsU8a(file)
const encoded_hash = multihash.encode(hash, 'blake2b-256');

const cid = new CID(1, 'blake2b-256', encoded_hash)
console.log(cid.toString());

const txHash = await api.tx.transactionStorage.store('0x' + file.toString('hex')).signAndSend(alice);

Data can be queried over IPFS

ipfs swarm connect <bizinikiwi peer address>
ipfs block get /ipfs/<CID> > kitten.jpeg

To renew data and prevent it from being disposed after the storage period, use transactionStorage.renew(block, index) where block is the block number of the previous store or renew transaction, and index is the index of that transaction in the block.

License: Apache-2.0