feature: add initial integration tests

Author: Ricardo Alonzo

.gitignore

@@ -1,2 +1,13 @@
 node_modules
-coverage
+coverage
+
+# Hardhat / hardhat-tron build output (generated, not committed)
+/artifacts/
+/cache/
+/cache_hardhat-tron/
+**/artifacts-tron/
+**/cache-tron/
+
+# Docker Tron node data
+datadir/
+logs/

README.md

@@ -647,13 +647,30 @@ npm run lint:fix
 ### Testing
 
 ```bash
-# Run tests
+# Run unit tests
 npm test
 
-# Run tests with coverage
+# Run unit tests with coverage
 npm run test:coverage
 ```
 
+### Integration Testing
+
+Integration tests run against a local Tron private network in Docker. They exercise full end-to-end flows: account derivation, TRX transfers, TRC20 token transfers, fee quoting, message signing, read-only accounts, disposal, and fee limits.
+
+**Prerequisites:** Docker must be installed and running.
+
+```bash
+# Start the local Tron node
+npm run test:integration:docker:up
+
+# Run integration tests
+npm run test:integration
+
+# Stop the local Tron node
+npm run test:integration:docker:down
+```
+
 ## 📜 License
 
 This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.