Learn-skills.dev mots-transaction-semantics

Points to the MoTS (Know Your Transactions) open-source Python/Scrapy research codebase—EVM transaction acquisition, semantic-vector extraction, and Etherscan-backed action labels (WWW 2023). Use when the user cites the MoTS paper/repo, needs legacy spider names (blocks.eth, blocks.semantic.eth, labels.action), or wants to relate transaction semantics to blockchain-analytics-operations—not as a substitute for current BlockchainSpider docs, RPC ToS, or legal review.

install

source · Clone the upstream repo

git clone https://github.com/NeverSight/learn-skills.dev

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/NeverSight/learn-skills.dev "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/skills-md/agentic-reserve/blockint-skills/mots-transaction-semantics" ~/.claude/skills/neversight-learn-skills-dev-mots-transaction-semantics && rm -rf "$T"

manifest: data/skills-md/agentic-reserve/blockint-skills/mots-transaction-semantics/SKILL.md

source content

MoTS — transaction semantic representation (research codebase)

Reference skill. Upstream states that MoTS is merged into BlockchainSpider—prefer the BlockchainSpider documentation for current spiders and maintenance. This skill documents the standalone MoTS repository for paper reproduction, historical commands, and skill discovery.

Repository: github.com/wuzhy1ng/MoTS
Paper (in repo): MoTS_WWW_2023_manuscript.pdf — Know Your Transactions: Real-time and Generic Transaction Semantic Representation on Blockchain & Web3 Ecosystem (ACM WWW 2023).

What the standalone repo implements

Step Spider (examples from upstream README) Role

Acquisition

blocks.eth

Collect txs from RPC over block ranges;

types

can include

external

internal

erc20

erc721

erc1155

Semantics

blocks.semantic.eth

Same shape of inputs plus transaction semantic vectors (per upstream description).

Labels

labels.action

Transaction semantics labels sourced via Etherscan-class APIs (block-range oriented in examples).

Storage: outputs under

./data

(per upstream README). Config: upstream points to

APIKEYS

PROVIDERS

, and

CONCURRENT_REQUESTS

settings.py

Install (clone upstream)

The dependency file is named

requiremets.txt

in the repository (upstream spelling). After clone:

pip install -r requiremets.txt

Confirm the filename on the branch you use—it may be renamed in a future commit.

Example command shapes (placeholders only)

# Block-range acquisition (replace RPC and range; confirm spider names in upstream README)
scrapy crawl blocks.eth -a start_blk=<N> -a end_blk=<M> -a types=external,internal,erc20,erc721,erc1155

# Semantic vectors + data (same placeholders)
scrapy crawl blocks.semantic.eth -a start_blk=<N> -a end_blk=<M> -a types=external,internal,erc20,erc721,erc1155

# Label-oriented crawl (Etherscan-class API key must be set per settings)
scrapy crawl labels.action -a start_blk=<N> -a end_blk=<M>

end_blk

is omitted in upstream examples, collection may follow the chain tip—mind RPC cost and rate limits.

How to combine with blockint

Task	Skill
Current Scrapy toolkit, Solana + EVM breadth	blockchain-spider-toolkit (BlockchainSpider)
Analytics / AML framing of “transaction meaning”	blockchain-analytics-operations
EVM DeFi triage	evm-solidity-defi-triage-agent

Guardrails

Prefer BlockchainSpider for new work if upstream merge note still applies—avoid duplicating unmaintained forks.
Configure your own
```
APIKEYS
```
and
```
PROVIDERS
```
; never commit or paste live keys.
Respect Etherscan (and similar) ToS and rate limits; semantic labels are research artifacts, not compliance verdicts.
Lawful use only; outputs are not a substitute for licensed analytics or legal conclusions.

Goal: a discoverable pointer to MoTS and its relationship to BlockchainSpider for blockint users researching transaction semantics and KYT-style representations.