# @lukso/lsp7-contracts
> Package for the LSP7 Digital Asset standard
Latest version **0.18.1** (published 2026-06-02) · Apache-2.0 license · 0 weekly downloads
## Install
```sh
npm install @lukso/lsp7-contracts
pnpm add @lukso/lsp7-contracts
yarn add @lukso/lsp7-contracts
bun add @lukso/lsp7-contracts
```
## Health
**Score 70/100 (B)** — status: active.
Positive: has types; esm support; no vulnerabilities; has provenance; high maintenance score; high quality score.
Warnings: low downloads; pre 1.0.
## Facts
| | |
|---|---|
| Version | 0.18.1 |
| Published | 2026-06-02 |
| First published | 2024-03-07 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 5 |
| Unpacked size | 3.3 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 88 |
| Maintainers | frozeman, lukso-network |
| Keywords | LUKSO, LSP, Blockchain, Standards, Smart Contracts, Ethereum, EVM, Solidity |
## Links
- npm: https://www.npmjs.com/package/@lukso/lsp7-contracts
- Repository: https://github.com/lukso-network/lsp-smart-contracts
- Homepage: https://github.com/lukso-network/lsp-smart-contracts#readme
- Issues: https://github.com/lukso-network/lsp-smart-contracts/issues
- npm.io page: https://npm.io/package/@lukso/lsp7-contracts
## Dependencies (5)
- [@lukso/lsp1-contracts](https://npm.io/package/@lukso/lsp1-contracts.md) ~0.16.0
- [@lukso/lsp2-contracts](https://npm.io/package/@lukso/lsp2-contracts.md) ~0.16.0
- [@lukso/lsp4-contracts](https://npm.io/package/@lukso/lsp4-contracts.md) ~0.17.0
- [@openzeppelin/contracts](https://npm.io/package/@openzeppelin/contracts.md) ^4.9.6
- [@lukso/lsp17contractextension-contracts](https://npm.io/package/@lukso/lsp17contractextension-contracts.md) ~0.17.0
## Alternatives
- [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads
- [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads
- [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads
- [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads
- [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads
## Recent versions
- 0.18.1 (latest) — 2026-06-02
- 0.15.0-rc.5 (rc) — 2024-04-03
- 0.17.3 — 2026-05-25
- 0.16.8 — 2025-06-19
- 0.16.6 — 2025-06-19
- 0.16.5 — 2025-06-18
- 0.16.4 — 2025-04-19
- 0.16.3 — 2025-01-17
- 0.16.2 — 2025-01-14
- 0.15.0 — 2024-04-05
- 0.15.0-rc.4 — 2024-04-02
- 0.15.0-rc.1 — 2024-03-22
- 0.15.0-rc.0 — 2024-03-07
## README
# LSP7 Digital Asset · [](https://www.npmjs.com/package/@lukso/lsp7-contracts)
> The contracts [`LSP7Votes`](contracts/extensions/LSP7Votes/LSP7Votes.sol) and [`LSP7VotesInitAbstract`](contracts/extensions/LSP7Votes/LSP7VotesInitAbstract.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 LSP7 Digital Asset standard (fungible token).
## Installation
```console
npm install @lukso/lsp7-contracts
```
## Available Constants & Types
The `@lukso/lsp7-contracts` npm package contains useful constants such as interface IDs or ERC725Y data keys related to the LSP7 Standard. You can import and access them as follows.
In JavaScript.
```javascript
import {
INTERFACE_ID_LSP7,
INTERFACE_ID_LSP7_PREVIOUS,
LSP7_TYPE_IDS,
} from "@lukso/lsp7-contracts";
```
In Solidity.
```solidity
import {
_INTERFACEID_LSP7,
_INTERFACEID_LSP7_V0_12_0,
_INTERFACEID_LSP7_V0_14_0,
_TYPEID_LSP7_DELEGATOR,
_TYPEID_LSP7_DELEGATEE,
_TYPEID_LSP7_TOKENSSENDER,
_TYPEID_LSP7_TOKENSRECIPIENT,
_TYPEID_LSP7_TOKENOPERATOR
} from "@lukso/lsp7-contracts/contracts/LSP7Constants.sol";
```
The `LSP7_TYPE_IDS` object includes type IDs for the following types of notifications:
```console
'LSP7Tokens_SenderNotification';
'LSP7Tokens_RecipientNotification';
'LSP7Tokens_OperatorNotification';
'LSP7Tokens_VotesDelegatorNotification';
'LSP7Tokens_VotesDelegateeNotification';
```
## TypeScript types
You can also import the [type-safe ABI](https://abitype.dev/) from the `/abi` path.
```ts
import {
// standard version
lsp7DigitalAssetAbi,
lsp7CappedSupplyAbi,
lsp7MintableAbi,
lsp7VotesAbi
// proxy version
lsp7CappedSupplyInitAbstractAbi,
lsp7DigitalAssetInitAbstractAbi,
lsp7MintableInitAbi,
} from '@lukso/lsp7-contracts/abi';
```
## Foundry deployment
This package includes two Foundry scripts to deploy the `LSP7CustomizableTokenInit` and `LSP7MintableInit` implementation contracts.
- `scripts/DeployLSP7CustomizableTokenInit.s.sol`
- `scripts/DeployLSP7MintableInit.s.sol`
Set your deployer key first:
```console
export PRIVATE_KEY=0x...
```
## Dry run against LUKSO Testnet
LSP7CustomizableTokenInit
```console
FOUNDRY_PROFILE=lsp7 forge script packages/lsp7-contracts/scripts/DeployLSP7CustomizableTokenInit.s.sol:DeployLSP7CustomizableTokenInitScript --rpc-url https://rpc.testnet.lukso.network
```
LSP7MintableInit
```console
FOUNDRY_PROFILE=lsp7 forge script packages/lsp7-contracts/scripts/DeployLSP7MintableInit.s.sol:DeployLSP7MintableInitScript --rpc-url https://rpc.testnet.lukso.network
```
## 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
LSP7CustomizableTokenInit
```console
FOUNDRY_PROFILE=lsp7 forge script packages/lsp7-contracts/scripts/DeployLSP7CustomizableTokenInit.s.sol:DeployLSP7CustomizableTokenInitScript --rpc-url https://rpc.testnet.lukso.network --broadcast
```
LSP7MintableInit
```console
FOUNDRY_PROFILE=lsp7 forge script packages/lsp7-contracts/scripts/DeployLSP7MintableInit.s.sol:DeployLSP7MintableInitScript --rpc-url https://rpc.testnet.lukso.network --broadcast
```
Broadcast and verify on the LUKSO Testnet Blockscout explorer:
LSP7CustomizableTokenInit
```console
FOUNDRY_PROFILE=lsp7 forge script packages/lsp7-contracts/scripts/DeployLSP7CustomizableTokenInit.s.sol:DeployLSP7CustomizableTokenInitScript --rpc-url https://rpc.testnet.lukso.network --broadcast --verify --verifier blockscout --verifier-url https://explorer.execution.testnet.lukso.network/api/
```
LSP7MintableInit
```console
FOUNDRY_PROFILE=lsp7 forge script packages/lsp7-contracts/scripts/DeployLSP7MintableInit.s.sol:DeployLSP7MintableInitScript --rpc-url https://rpc.testnet.lukso.network --broadcast --verify --verifier blockscout --verifier-url https://explorer.execution.testnet.lukso.network/api/
```
## Audits
The **LSP7 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**
- [`LSP7CustomizableToken`](contracts/presets/LSP7CustomizableToken.sol) (constructor-based deployment)
- [`LSP7CustomizableTokenInit`](contracts/presets/LSP7CustomizableTokenInit.sol) (proxy / upgradeable deployment)
- [`LSP7CustomizableTokenConstants`](contracts/presets/LSP7CustomizableTokenConstants.sol)
**Extensions** (standard and `Init` variants)
- [`AccessControlExtended`](contracts/extensions/AccessControlExtended/)
- [`LSP7Burnable`](contracts/extensions/LSP7Burnable/)
- [`LSP7Mintable`](contracts/extensions/LSP7Mintable/)
- [`LSP7CappedSupply`](contracts/extensions/LSP7CappedSupply/)
- [`LSP7CappedBalance`](contracts/extensions/LSP7CappedBalance/)
- [`LSP7NonTransferable`](contracts/extensions/LSP7NonTransferable/)
- [`LSP7Revokable`](contracts/extensions/LSP7Revokable/)
---
_Source: https://npm.io/package/@lukso/lsp7-contracts · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._