| name | mots-transaction-semantics |
| description | 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. |
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.
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 in 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)
scrapy crawl blocks.eth -a start_blk=<N> -a end_blk=<M> -a types=external,internal,erc20,erc721,erc1155
scrapy crawl blocks.semantic.eth -a start_blk=<N> -a end_blk=<M> -a types=external,internal,erc20,erc721,erc1155
scrapy crawl labels.action -a start_blk=<N> -a end_blk=<M>
If 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.
