{"_id":"@aptos-labs/forklift","_rev":"4-4344dcbde02daa3390d6466bd54b1abe","name":"@aptos-labs/forklift","dist-tags":{"latest":"1.1.1"},"versions":{"1.0.0":{"name":"@aptos-labs/forklift","version":"1.0.0","keywords":["aptos","move","blockchain","smart-contracts","testing","simulation","web3"],"author":{"name":"Aptos Labs"},"license":"Apache-2.0","_id":"@aptos-labs/forklift@1.0.0","maintainers":[{"name":"aptos-labs","email":"npmjs@aptoslabs.com"}],"homepage":"https://github.com/aptos-labs/forklift#readme","bugs":{"url":"https://github.com/aptos-labs/forklift/issues"},"dist":{"shasum":"e07326cbccd9430def6b09f5892116c7b79e6de5","tarball":"https://registry.npmjs.org/@aptos-labs/forklift/-/forklift-1.0.0.tgz","fileCount":10,"integrity":"sha512-gtn3PVyYcgJnXfhdIM211T5IL1izW7rYdRhirH7C/XcQ+/mLQcJa1gBH/pnt4ZosWz7vounWo/ULDwAR5ysCQw==","signatures":[{"sig":"MEQCIHyokBp+75MQPXC3wZ797gt3z8+nYqbTaF/vcr+CndXBAiALnUuYWAjbTDkgxeIm2rtuM2Rq1p08E4sBiNXchbPjAQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":86955},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18"},"gitHead":"eb1404958b3a688eab9f859079b7d5dcebb9c704","scripts":{"build":"tsc","format":"prettier --write \"src/**/*.ts\"","format:check":"prettier --check \"src/**/*.ts\"","prepublishOnly":"npm run build"},"_npmUser":{"name":"aptos-labs","email":"npmjs@aptoslabs.com"},"repository":{"url":"git+https://github.com/aptos-labs/forklift.git","type":"git","directory":"packages/forklift"},"_npmVersion":"11.7.0","description":"TypeScript framework for developing, testing, and scripting Aptos Move smart contracts","directories":{},"_nodeVersion":"22.21.1","dependencies":{"js-yaml":"^4.1.1","smol-toml":"^1.6.0","sync-fetch":"^0.6.0","@aptos-labs/ts-sdk":"^5.1.6"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","prettier":"^3.8.1","typescript":"^5.9.3","@types/jest":"^29.5.14","@types/node":"^22.0.0","@types/js-yaml":"^4.0.9","@types/sync-fetch":"^0.4.3"},"_npmOperationalInternal":{"tmp":"tmp/forklift_1.0.0_1769717378350_0.47471717862022333","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@aptos-labs/forklift","version":"1.0.1","keywords":["aptos","move","blockchain","smart-contracts","testing","simulation","web3"],"author":{"name":"Aptos Labs"},"license":"Apache-2.0","_id":"@aptos-labs/forklift@1.0.1","maintainers":[{"name":"aptos-labs","email":"npmjs@aptoslabs.com"}],"homepage":"https://github.com/aptos-labs/forklift#readme","bugs":{"url":"https://github.com/aptos-labs/forklift/issues"},"dist":{"shasum":"1beb70b9fe9ddda58c2db1e30274288f0f987704","tarball":"https://registry.npmjs.org/@aptos-labs/forklift/-/forklift-1.0.1.tgz","fileCount":11,"integrity":"sha512-9TduqIZXWk4GO7XWTd3SNKTaisbOWbp+RNpNl9zUb9HqYLyyrHKp+FwlP8Zx/1cFn979ehHte9R+PTgJge7jlg==","signatures":[{"sig":"MEUCIDVY/A/tA1oljlXM01X3ZiXHmchcI/GyGx12wN0/+9kJAiEA6iIPstWLSlx44llE60ZWILGH4St21eW2jAE+N7R8hU0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":88677},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18"},"gitHead":"1fc3d32ac1290063291ef2499f129cddf9625165","scripts":{"build":"tsc","format":"prettier --write \"src/**/*.ts\"","format:check":"prettier --check \"src/**/*.ts\"","prepublishOnly":"npm run build"},"_npmUser":{"name":"aptos-labs","email":"npmjs@aptoslabs.com"},"repository":{"url":"git+https://github.com/aptos-labs/forklift.git","type":"git","directory":"packages/forklift"},"_npmVersion":"11.7.0","description":"TypeScript framework for developing, testing, and scripting Aptos Move smart contracts","directories":{},"_nodeVersion":"22.21.1","dependencies":{"js-yaml":"^4.1.1","smol-toml":"^1.6.0","sync-fetch":"^0.6.0","@aptos-labs/ts-sdk":"^5.1.6"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","prettier":"^3.8.1","typescript":"^5.9.3","@types/jest":"^29.5.14","@types/node":"^22.0.0","@types/js-yaml":"^4.0.9","@types/sync-fetch":"^0.4.3"},"_npmOperationalInternal":{"tmp":"tmp/forklift_1.0.1_1769718454623_0.4832764190831449","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@aptos-labs/forklift","version":"1.1.0","keywords":["aptos","move","blockchain","smart-contracts","testing","simulation","web3"],"author":{"name":"Aptos Labs"},"license":"Apache-2.0","_id":"@aptos-labs/forklift@1.1.0","maintainers":[{"name":"aptos-labs","email":"npmjs@aptoslabs.com"}],"homepage":"https://github.com/aptos-labs/forklift#readme","bugs":{"url":"https://github.com/aptos-labs/forklift/issues"},"dist":{"shasum":"0fae35aff469deda0410df3de5976ff72c4915bd","tarball":"https://registry.npmjs.org/@aptos-labs/forklift/-/forklift-1.1.0.tgz","fileCount":12,"integrity":"sha512-o0hnEX6FmOnBIllxrmD2ibWIadqTZ6tK3gQ2P3dJKUnbG4mtJDxrGT7+fT4re6z+/hsmgrU9YZjvpmnVQn6ZRg==","signatures":[{"sig":"MEUCIQDD5jMQF4Yp3SeKUCrTc6tr30g4pOsuMzQncJ8BNjXWQwIgVA9AB9VJUb1KAzBZZHXJXex3jlkupZVkLft9+tWq0Zw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":101556},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18"},"gitHead":"b5d98cd8840e6e7c26df8ad28aba6d42d5755f3f","scripts":{"build":"tsc","format":"prettier --write \"src/**/*.ts\"","format:check":"prettier --check \"src/**/*.ts\"","prepublishOnly":"npm run build"},"_npmUser":{"name":"aptos-labs","email":"npmjs@aptoslabs.com"},"repository":{"url":"git+https://github.com/aptos-labs/forklift.git","type":"git","directory":"packages/forklift"},"_npmVersion":"10.9.4","description":"TypeScript framework for developing, testing, and scripting Aptos Move smart contracts","directories":{},"_nodeVersion":"22.21.1","dependencies":{"js-yaml":"^4.1.1","smol-toml":"^1.6.0","sync-fetch":"^0.6.0","@aptos-labs/ts-sdk":"^5.1.6"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","prettier":"^3.8.1","typescript":"^5.9.3","@types/jest":"^29.5.14","@types/node":"^22.0.0","@types/js-yaml":"^4.0.9","@types/sync-fetch":"^0.4.3"},"_npmOperationalInternal":{"tmp":"tmp/forklift_1.1.0_1771616886799_0.6364837899601621","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@aptos-labs/forklift","version":"1.1.1","description":"TypeScript framework for developing, testing, and scripting Aptos Move smart contracts","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","prepublishOnly":"npm run build","format":"prettier --write \"src/**/*.ts\"","format:check":"prettier --check \"src/**/*.ts\""},"keywords":["aptos","move","blockchain","smart-contracts","testing","simulation","web3"],"author":{"name":"Aptos Labs"},"license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/aptos-labs/forklift.git","directory":"packages/forklift"},"homepage":"https://github.com/aptos-labs/forklift#readme","bugs":{"url":"https://github.com/aptos-labs/forklift/issues"},"engines":{"node":">=18"},"devDependencies":{"@types/jest":"^29.5.14","@types/js-yaml":"^4.0.9","@types/node":"^22.0.0","@types/sync-fetch":"^0.4.3","prettier":"^3.8.1","ts-node":"^10.9.2","typescript":"^5.9.3"},"dependencies":{"@aptos-labs/ts-sdk":"^5.1.6","js-yaml":"^4.1.1","smol-toml":"^1.6.0","sync-fetch":"^0.6.0"},"gitHead":"c76b1e05a97deb8bbd5fd9dad5f16b6f34249b12","_id":"@aptos-labs/forklift@1.1.1","_nodeVersion":"24.13.1","_npmVersion":"11.8.0","dist":{"integrity":"sha512-rjyhV4403WBEW01QimIApdy8dMUTcNCyvrZDCwRNE2sTyPkoKjxXIv1+W1eS0eYePUhlwWuqZegbi2YRbNQ7tw==","shasum":"5d37f6ede71f8291eca2cdec13a2bf17611d060f","tarball":"https://registry.npmjs.org/@aptos-labs/forklift/-/forklift-1.1.1.tgz","fileCount":12,"unpackedSize":102988,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aptos-labs%2fforklift@1.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAsbsL416SAsD4kpIiTLHkE1TjUrE8Sya5qal4UfqrNRAiEA4F4469lI6mMTJvnRWq4ymIZeVbCG7CyEsrI60dVeOFg="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:1e420d32-0276-40e3-9b2c-fd57a8986531"}},"directories":{},"maintainers":[{"name":"aptos-labs","email":"npmjs@aptoslabs.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/forklift_1.1.1_1772146488817_0.3644913501937097"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-29T20:09:38.193Z","modified":"2026-02-26T22:54:49.281Z","1.0.0":"2026-01-29T20:09:38.513Z","1.0.1":"2026-01-29T20:27:34.772Z","1.1.0":"2026-02-20T19:48:06.962Z","1.1.1":"2026-02-26T22:54:48.964Z"},"bugs":{"url":"https://github.com/aptos-labs/forklift/issues"},"author":{"name":"Aptos Labs"},"license":"Apache-2.0","homepage":"https://github.com/aptos-labs/forklift#readme","keywords":["aptos","move","blockchain","smart-contracts","testing","simulation","web3"],"repository":{"type":"git","url":"git+https://github.com/aptos-labs/forklift.git","directory":"packages/forklift"},"description":"TypeScript framework for developing, testing, and scripting Aptos Move smart contracts","maintainers":[{"name":"aptos-labs","email":"npmjs@aptoslabs.com"}],"readme":"# Forklift\n\nForklift is a TypeScript framework for developing, testing, and scripting Aptos Move smart contracts. It provides a unified interface — the `Harness` class — that works across local simulation, network forking, and live network execution.\n\n## Features\n\n- **Local Simulation**: Develop and test without any network. Runs entirely in memory with instant execution. Includes test-only APIs like instant account funding.\n- **Network Forking**: Test against real Mainnet/Testnet/Devnet state without spending gas or affecting the network.\n- **Live Scripting**: Deploy contracts and execute transactions on real networks using the same code you tested locally.\n- **TypeScript Native**: Write tests and scripts in standard TypeScript with full Node.js capabilities.\n- **Easy Setup**: No need to manually spawn or manage a local validator node. Forklift handles the simulation lifecycle automatically.\n- **Isolation & Repeatability**: Each session runs in isolation with deterministic results — perfect for automated testing/CI.\n\n## Installation\n\n```bash\nnpm install @aptos-labs/forklift\n```\n\n**Prerequisites:** Node.js v18+ and [Aptos CLI](https://aptos.dev/tools/aptos-cli/) v8.1.0+\n\n## Quick Start\n\n```typescript\nimport { Harness } from \"@aptos-labs/forklift\";\n\nconst harness = Harness.createLocal();\n\nharness.initCliProfile(\"alice\");\nharness.fundAccount(\"alice\", 100_000_000);\n\nconst result = harness.deployCodeObject({\n  sender: \"alice\",\n  packageDir: \"./move/my_contract\",\n  packageAddressName: \"my_contract\",\n});\n\nharness.cleanup();\n```\n\n## Documentation\n\nFor full documentation, API reference, and examples, see the [GitHub repository](https://github.com/aptos-labs/forklift).\n\n## License\n\nApache-2.0\n","readmeFilename":"README.md"}