Story Proof-of-Creativity Periphery


Welcome to the Story PoC Periphery repository. This repository contains the peripheral smart contracts for the Story Proof-of-Creativity (PoC) Protocol. These contracts simplify developers’ work by allowing them to bundle multiple interactions with the PoC protocol - like registering an IP Asset and attaching License Terms to that IP Asset - into a single transaction.

For access to the core PoC contracts, please visit the protocol-core-v1 repository.

Documentation

>📘 Learn more about Story

Story PoC Periphery combines multiple common independent interactions with the Story PoC Protocol into a single transaction.
For example, this mintAndRegisterIpAndAttachPILTerms is one of the functions that allows you to mint an NFT, register it as an IP Asset, attach License Terms, and setting Licensing Configuration all in one call.
``solidity
function mintAndRegisterIpAndAttachPILTerms(
address spgNftContract,
address recipient,
WorkflowStructs.IPMetadata calldata ipMetadata,
WorkflowStructs.LicenseTermsData[] calldata licenseTermsData,
bool allowDuplicates
) external onlyCallerWithMinterRole(nftContract) returns (address ipId, uint256 tokenId, uint256 licenseTermsId)
`

$3

For a list of currently supported workflows, check out the Workflows documentation.

$3

Batch calling functions is supported both natively and through the Multicall3 contract. For more information, check out the Multicall documentation.

$3

Audit reports are available in the ./audits directory.

$3

 contracts are deployed on Story. The contract addresses can be found in deployment-1315.json (Story Aeneid Testnet) and deployment-1514.json (Story Homer Mainnet).

Quick Start

$3

Please install Foundry / Foundryup

$3

`sh
yarn # this installs packages
forge build # this builds
`

$3

`sh
forge clean
forge compile --build-info
`

$3

1. Edit script/foundry/utils/upgrades/ERC7201Helper.s.sol
2. Change string constant CONTRACT_NAME = "";
3. Run the script to generate boilerplate code for storage handling and the namespace hash:

`sh
forge script script/utils/upgrades/ERC7201Helper.s.sol
`

4. The log output is the boilerplate code, copy and paste in your contract

$3

`
forge test -vvvv
`

$3

`
forge coverage
`

$3

Foundry comes with local network anvil baked in, and allows us to deploy to our local network for quick testing locally.

To start a local network run:

`
make anvil
`

This will spin up a local blockchain with a determined private key, so you can use the same private key each time.

$3

We employed solhint to check code style.
To check code style with solhint run:

`
make lint
`

To re-format code with prettier run:

`
make format
`

$3

We use slither, a popular security framework from Trail of Bits. To use slither, you'll first need to install python and install slither.

Then, you can run:

`
make slither
``

And get your slither output.

Contributing

Please see our contribution guidelines.

Licensing

MIT License, details see: LICENSE.