@lukso/lsp8-contracts 0.17.3 → 0.18.1

package/README.md

@@ -1,29 +1,9 @@
 # LSP8 Identifiable Digital Asset · [![npm version](https://img.shields.io/npm/v/@lukso/lsp8-contracts.svg?style=flat)](https://www.npmjs.com/package/@lukso/lsp8-contracts)
 
-npm package for the LSP8 Identifiable Digital Asset standard (NFTs and similar token IDs).
-
-## Audits
-
-The **LSP8 Customizable Token** presets and their token extensions listed below were reviewed by the AI auditing tool [Nethermind AI Audit Agent](https://www.nethermind.io/) (May 2026). See the [audit report PDF](../../audits/Nethermind_AI_Audit_Agent_2026_05_19.pdf).
-
-**Presets**
-
-- [`LSP8CustomizableToken`](contracts/presets/LSP8CustomizableToken.sol) (constructor-based deployment)
-- [`LSP8CustomizableTokenInit`](contracts/presets/LSP8CustomizableTokenInit.sol) (proxy / upgradeable deployment)
-- [`LSP8CustomizableTokenConstants`](contracts/presets/LSP8CustomizableTokenConstants.sol)
-
-**Extensions** (standard and `Init` variants)
-
-- [`AccessControlExtended`](contracts/extensions/AccessControlExtended/)
-- [`LSP8Burnable`](contracts/extensions/LSP8Burnable/)
-- [`LSP8Mintable`](contracts/extensions/LSP8Mintable/)
-- [`LSP8CappedSupply`](contracts/extensions/LSP8CappedSupply/)
-- [`LSP8CappedBalance`](contracts/extensions/LSP8CappedBalance/)
-- [`LSP8NonTransferable`](contracts/extensions/LSP8NonTransferable/)
-- [`LSP8Revokable`](contracts/extensions/LSP8Revokable/)
-
 > The contracts [`LSP8Votes`](contracts/extensions/LSP8Votes/LSP8Votes.sol) and [`LSP8VotesInitAbstract`](contracts/extensions/LSP8Votes/LSP8VotesInitAbstract.sol) have not been formally audited by an external third party and are not recommended to be used in production without undergoing an independent security audit.
 
+npm package for the LSP8 Identifiable Digital Asset standard (NFTs token IDs).
+
 ## Installation
 
 ```console
@@ -93,7 +73,10 @@ import {
 
 ## Foundry deployment
 
-This package includes a Foundry script at `scripts/DeployLSP8CustomizableTokenInit.s.sol` to deploy the `LSP8CustomizableTokenInit` implementation contract.
+This package includes two Foundry scripts to deploy the `LSP8CustomizableTokenInit` and `LSP8MintableInit` implementation contracts.
+
+- `scripts/DeployLSP8CustomizableTokenInit.s.sol`
+- `scripts/DeployLSP8MintableInit.s.sol`
 
 Set your deployer key first:
 
@@ -103,20 +86,82 @@ export PRIVATE_KEY=0x...
 
 ## Dry run against LUKSO Testnet
 
+<details>
+  <summary><code>LSP8CustomizableTokenInit</code></summary>
+
 ```console
 FOUNDRY_PROFILE=lsp8 forge script packages/lsp8-contracts/scripts/DeployLSP8CustomizableTokenInit.s.sol:DeployLSP8CustomizableTokenInitScript --rpc-url https://rpc.testnet.lukso.network
 ```
 
+</details>
+
+<details>
+  <summary><code>LSP8MintableInit</code></summary>
+
+```console
+FOUNDRY_PROFILE=lsp8 forge script packages/lsp8-contracts/scripts/DeployLSP8MintableInit.s.sol:DeployLSP8MintableInitScript --rpc-url https://rpc.testnet.lukso.network
+```
+
+</details>
+
 ## Broadcast the deployment
 
 > Use one of the methods described in the [foundry docs](https://www.getfoundry.sh/forge/scripting#providing-a-private-key) to broadcast from a specific address
 
+<details>
+  <summary><code>LSP8CustomizableTokenInit</code></summary>
+
 ```console
 FOUNDRY_PROFILE=lsp8 forge script packages/lsp8-contracts/scripts/DeployLSP8CustomizableTokenInit.s.sol:DeployLSP8CustomizableTokenInitScript --rpc-url https://rpc.testnet.lukso.network --broadcast
 ```
 
+</details>
+
+<details>
+  <summary><code>LSP8MintableInit</code></summary>
+
+```console
+FOUNDRY_PROFILE=lsp8 forge script packages/lsp8-contracts/scripts/DeployLSP8MintableInit.s.sol:DeployLSP8MintableInitScript --rpc-url https://rpc.testnet.lukso.network --broadcast
+```
+
+</details>
+
 Broadcast and verify on the LUKSO Testnet Blockscout explorer:
 
+<details>
+  <summary><code>LSP8CustomizableTokenInit</code></summary>
+
+```console
+FOUNDRY_PROFILE=lsp8 forge script packages/lsp8-contracts/scripts/DeployLSP8CustomizableTokenInit.s.sol:DeployLSP8CustomizableTokenInitScript --rpc-url https://rpc.testnet.lukso.network --broadcast --verify --verifier blockscout --verifier-url https://explorer.execution.testnet.lukso.network/api/
+```
+
+</details>
+
+<details>
+  <summary><code>LSP8MintableInit</code></summary>
+
 ```console
-FOUNDRY_PROFILE=lsp8 forge script packages/lsp8-contracts/scripts/DeployLSP8CustomizableTokenInit.s.sol:DeployLSP8CustomizableTokenInitScript --rpc-url https://rpc.testnet.lukso.network --broadcast --verify --verifier blockscout --verifier-url https://api.explorer.execution.testnet.lukso.network/api?
+FOUNDRY_PROFILE=lsp8 forge script packages/lsp8-contracts/scripts/DeployLSP8MintableInit.s.sol:DeployLSP8MintableInitScript --rpc-url https://rpc.testnet.lukso.network --broadcast --verify --verifier blockscout --verifier-url https://explorer.execution.testnet.lukso.network/api/
 ```
+
+</details>
+
+## Audits
+
+The **LSP8 Customizable Token** presets and their token extensions listed below were reviewed by the AI auditing tool [Nethermind AI Audit Agent](https://www.nethermind.io/) (May 2026). See the [audit report PDF](../../audits/Nethermind_AI_Audit_Agent_2026_05_19.pdf).
+
+**Presets**
+
+- [`LSP8CustomizableToken`](contracts/presets/LSP8CustomizableToken.sol) (constructor-based deployment)
+- [`LSP8CustomizableTokenInit`](contracts/presets/LSP8CustomizableTokenInit.sol) (proxy / upgradeable deployment)
+- [`LSP8CustomizableTokenConstants`](contracts/presets/LSP8CustomizableTokenConstants.sol)
+
+**Extensions** (standard and `Init` variants)
+
+- [`AccessControlExtended`](contracts/extensions/AccessControlExtended/)
+- [`LSP8Burnable`](contracts/extensions/LSP8Burnable/)
+- [`LSP8Mintable`](contracts/extensions/LSP8Mintable/)
+- [`LSP8CappedSupply`](contracts/extensions/LSP8CappedSupply/)
+- [`LSP8CappedBalance`](contracts/extensions/LSP8CappedBalance/)
+- [`LSP8NonTransferable`](contracts/extensions/LSP8NonTransferable/)
+- [`LSP8Revokable`](contracts/extensions/LSP8Revokable/)

package/artifacts/IAccessControlExtended.json

@@ -281,5 +281,5 @@
   "deployedLinkReferences": {},
   "immutableReferences": {},
   "inputSourceName": "project/contracts/extensions/AccessControlExtended/IAccessControlExtended.sol",
-  "buildInfoId": "solc-0_8_28-51761251365f530b69e394f3aa78b9f98e3e9d6a"
+  "buildInfoId": "solc-0_8_28-a1f189205db65800e276c245fa7f2fa7071cb3a5"
 }

package/artifacts/ILSP8CappedBalance.json

@@ -23,5 +23,5 @@
   "deployedLinkReferences": {},
   "immutableReferences": {},
   "inputSourceName": "project/contracts/extensions/LSP8CappedBalance/ILSP8CappedBalance.sol",
-  "buildInfoId": "solc-0_8_28-51761251365f530b69e394f3aa78b9f98e3e9d6a"
+  "buildInfoId": "solc-0_8_28-a1f189205db65800e276c245fa7f2fa7071cb3a5"
 }

package/artifacts/ILSP8CappedSupply.json

@@ -23,5 +23,5 @@
   "deployedLinkReferences": {},
   "immutableReferences": {},
   "inputSourceName": "project/contracts/extensions/LSP8CappedSupply/ILSP8CappedSupply.sol",
-  "buildInfoId": "solc-0_8_28-51761251365f530b69e394f3aa78b9f98e3e9d6a"
+  "buildInfoId": "solc-0_8_28-a1f189205db65800e276c245fa7f2fa7071cb3a5"
 }

package/artifacts/ILSP8IdentifiableDigitalAsset.json

@@ -489,5 +489,5 @@
   "deployedLinkReferences": {},
   "immutableReferences": {},
   "inputSourceName": "project/contracts/ILSP8IdentifiableDigitalAsset.sol",
-  "buildInfoId": "solc-0_8_28-51761251365f530b69e394f3aa78b9f98e3e9d6a"
+  "buildInfoId": "solc-0_8_28-a1f189205db65800e276c245fa7f2fa7071cb3a5"
 }

package/artifacts/ILSP8Mintable.json

@@ -58,5 +58,5 @@
   "deployedLinkReferences": {},
   "immutableReferences": {},
   "inputSourceName": "project/contracts/extensions/LSP8Mintable/ILSP8Mintable.sol",
-  "buildInfoId": "solc-0_8_28-51761251365f530b69e394f3aa78b9f98e3e9d6a"
+  "buildInfoId": "solc-0_8_28-a1f189205db65800e276c245fa7f2fa7071cb3a5"
 }

package/artifacts/ILSP8NonTransferable.json

@@ -6,6 +6,12 @@
     {
       "anonymous": false,
       "inputs": [
+        {
+          "indexed": true,
+          "internalType": "bool",
+          "name": "nonTransferabilityEnabled",
+          "type": "bool"
+        },
         {
           "indexed": true,
           "internalType": "uint256",
@@ -44,7 +50,7 @@
     },
     {
       "inputs": [],
-      "name": "transferLockEnabled",
+      "name": "nonTransferabilityEnabled",
       "outputs": [
         {
           "internalType": "bool",
@@ -106,5 +112,5 @@
   "deployedLinkReferences": {},
   "immutableReferences": {},
   "inputSourceName": "project/contracts/extensions/LSP8NonTransferable/ILSP8NonTransferable.sol",
-  "buildInfoId": "solc-0_8_28-51761251365f530b69e394f3aa78b9f98e3e9d6a"
+  "buildInfoId": "solc-0_8_28-a1f189205db65800e276c245fa7f2fa7071cb3a5"
 }

package/artifacts/ILSP8Revokable.json

@@ -16,6 +16,43 @@
       "name": "RevokableStatusChanged",
       "type": "event"
     },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "revoker",
+          "type": "address"
+        },
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "from",
+          "type": "address"
+        },
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "to",
+          "type": "address"
+        },
+        {
+          "indexed": false,
+          "internalType": "bytes32",
+          "name": "tokenId",
+          "type": "bytes32"
+        },
+        {
+          "indexed": false,
+          "internalType": "bytes",
+          "name": "data",
+          "type": "bytes"
+        }
+      ],
+      "name": "TokenRevoked",
+      "type": "event"
+    },
     {
       "inputs": [],
       "name": "disableRevokable",
@@ -71,5 +108,5 @@
   "deployedLinkReferences": {},
   "immutableReferences": {},
   "inputSourceName": "project/contracts/extensions/LSP8Revokable/ILSP8Revokable.sol",
-  "buildInfoId": "solc-0_8_28-51761251365f530b69e394f3aa78b9f98e3e9d6a"
+  "buildInfoId": "solc-0_8_28-a1f189205db65800e276c245fa7f2fa7071cb3a5"
 }

package/artifacts/LSP8Burnable.json

@@ -942,5 +942,5 @@
   "deployedLinkReferences": {},
   "immutableReferences": {},
   "inputSourceName": "project/contracts/extensions/LSP8Burnable/LSP8Burnable.sol",
-  "buildInfoId": "solc-0_8_28-51761251365f530b69e394f3aa78b9f98e3e9d6a"
+  "buildInfoId": "solc-0_8_28-a1f189205db65800e276c245fa7f2fa7071cb3a5"
 }

package/artifacts/LSP8BurnableInitAbstract.json

@@ -950,5 +950,5 @@
   "deployedLinkReferences": {},
   "immutableReferences": {},
   "inputSourceName": "project/contracts/extensions/LSP8Burnable/LSP8BurnableInitAbstract.sol",
-  "buildInfoId": "solc-0_8_28-51761251365f530b69e394f3aa78b9f98e3e9d6a"
+  "buildInfoId": "solc-0_8_28-a1f189205db65800e276c245fa7f2fa7071cb3a5"
 }

package/artifacts/LSP8CappedBalanceAbstract.json

@@ -1281,5 +1281,5 @@
   "deployedLinkReferences": {},
   "immutableReferences": {},
   "inputSourceName": "project/contracts/extensions/LSP8CappedBalance/LSP8CappedBalanceAbstract.sol",
-  "buildInfoId": "solc-0_8_28-51761251365f530b69e394f3aa78b9f98e3e9d6a"
+  "buildInfoId": "solc-0_8_28-a1f189205db65800e276c245fa7f2fa7071cb3a5"
 }

package/artifacts/LSP8CappedBalanceInitAbstract.json

@@ -1289,5 +1289,5 @@
   "deployedLinkReferences": {},
   "immutableReferences": {},
   "inputSourceName": "project/contracts/extensions/LSP8CappedBalance/LSP8CappedBalanceInitAbstract.sol",
-  "buildInfoId": "solc-0_8_28-51761251365f530b69e394f3aa78b9f98e3e9d6a"
+  "buildInfoId": "solc-0_8_28-a1f189205db65800e276c245fa7f2fa7071cb3a5"
 }

package/artifacts/LSP8CappedSupplyAbstract.json

@@ -937,5 +937,5 @@
   "deployedLinkReferences": {},
   "immutableReferences": {},
   "inputSourceName": "project/contracts/extensions/LSP8CappedSupply/LSP8CappedSupplyAbstract.sol",
-  "buildInfoId": "solc-0_8_28-51761251365f530b69e394f3aa78b9f98e3e9d6a"
+  "buildInfoId": "solc-0_8_28-a1f189205db65800e276c245fa7f2fa7071cb3a5"
 }

package/artifacts/LSP8CappedSupplyInitAbstract.json

@@ -945,5 +945,5 @@
   "deployedLinkReferences": {},
   "immutableReferences": {},
   "inputSourceName": "project/contracts/extensions/LSP8CappedSupply/LSP8CappedSupplyInitAbstract.sol",
-  "buildInfoId": "solc-0_8_28-51761251365f530b69e394f3aa78b9f98e3e9d6a"
+  "buildInfoId": "solc-0_8_28-a1f189205db65800e276c245fa7f2fa7071cb3a5"
 }