smart-contracts

KO | EN

gitlite — search

#javascript #hacktoberfest #react #ai #typescript #go #machine-learning #nodejs #awesome #awesome-list #vue #security #mcp #open-source

smart-contracts

(★ 100)

A library of smart contracts

File Explorer

Download Latest Version (.zip)

- - fa2
  - fa2_clients
  - fa2_modules
- - .gitignore
  - .prettierrc
  - collection.test.ts
  - jest.config.js
  - origination.ts
  - package.json
  - promotion.ts
  - tsconfig.json
  - yarn.lock
- flextesa
- README.md
- - fa2
  - fa2_clients
  - fa2_modules
- - __init__.py
  - ligo.py
  - test_mac.py
  - test_token_owner_with_hooks.py
  - test_token_sorter.py
- flextesa
- MANIFEST.in
- multi_asset.md
- README.md
- setup.py
- - fa2
  - fa2_clients
  - fa2_modules
- - .prettierrc
  - fractional.test.ts
  - jest.config.js
  - origination.ts
  - package.json
  - tsconfig.json
  - yarn.lock
- flextesa
- README.md
- - fa2
  - fa2_modules
- - dao.ts
  - origination.ts
- - fractional-admin.test.ts
  - fractional-nft-transfer.test.ts
- .prettierrc
- flextesa
- jest.config.js
- package.json
- README.md
- tsconfig.json
- yarn.lock
- - fa2
  - fa2_clients
  - fa2_modules
- - __init__.py
  - ligo.py
  - test_granular_mac.py
  - test_mac.py
- flextesa
- MANIFEST.in
- multi_asset.md
- README.md
- setup.py
- - fa2
  - fa2_clients
  - fa2_modules
- - __init__.py
  - ligo.py
  - test_fa2.py
- flextesa
- MANIFEST.in
- README.md
- setup.py
- - fa2_errors.mligo
  - fa2_hook.mligo
  - fa2_interface.mligo
  - fa2_permissions_descriptor.mligo
- - README.md
  - token_owner.mligo
- - admin_sig.mligo
  - README.md
  - simple_admin.mligo
  - token_admin.mligo
  - token_sig.mligo
- - kill-sandbox.sh
  - start-sandbox.sh
- - ligo.py
- - .prettierrc
  - bootstrap-sandbox.ts
  - fa2-balance-inspector.ts
  - fa2-interface.ts
  - ligo.ts
  - package.json
  - tsconfig.json
  - type-aliases.ts
  - yarn.lock
- - fa2
  - fa2_clients
  - fa2_modules
- - Makefile
  - README.md
- - __init__.py
  - ligo.py
  - test_fa2.py
- flextesa
- MANIFEST.in
- README.md
- setup.py
.gitattributes
.gitignore
LICENSE
ligo.sh
README.md
upgradable_contract_draft.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# FA2 Contracts Implementation

This repository contains multiple sub-projects implementing different flavors of
the FA2 token standard.

## Shared LIGO code

[shared](shared) directory contains common code shared by all sub-project.
The FA2-related LIGO artifacts are:

- [shared/fa2](shared/fa2) - FA2 interface and standard errors definition.
- [shared/fa2/lib](shared/fa2/lib) - Helpers, various bits and pieces
  used by the FA2 implementation.
  - [shared/fa2/lib/fa2_operator_lib.mligo](shared/fa2/lib/fa2_operator_lib.mligo) -
    helper functions to manage and validate FA2 operators.
  - [shared/fa2/lib/fa2_owner_hook_lib.mligo](shared/fa2/lib/fa2_owner_hooks_lib.mligo) -
    helper functions to support sender/receiver hooks.
- [shared/fa2_modules](shared/fa2_modules) - modules implementing additional contract
  functionality to be mixed into the final FA2 contract.
  - [shared/fa2_modules/simple_admin.mligo](shared/fa2_modules/simple_admin.mligo) -
    implementation of the admin entry points that let to pause/unpause the contract
    and change the admin.
  - [shared/fa2_modules/token_admin.mligo](shared/fa2_modules/token_admin.mligo) -
    implementation of the admin entry points that let change the admin and
    pause/unpause transfers per individual tokens.
- [shared/fa2_clients](shared/fa2_clients) - FA2 client contracts used for testing.

## Sub-Projects Structure

The sub-projects symlink shared code into their respective directories. Each
sub-project has `ligo` directory that contains all LIGO-related files:

- symlinked shared common code.
- `src` directory with the LIGO implementation of the particular FA2 contract(s).
- `out` directory with the contracts compiled to Michelson.

The design of each FA2 contract follows the same pattern and consists of the following
source files:

- `fa2_xxx_token.mligo` - implementation of the FA2 entry points and FA2 core logic.
- `token_manager.mligo` - implementation of mint, burn, create token(s) entry points.
- `fa2_xxx_asset.mligo` - assembly of different modules into a complete FA2 contract.
  The assembly includes FA2 entry points and core logic (`fa2_xxx_token.mligo`),
  mint/burn entry points (`token_manager.mligo`)
  and the administrator entry points
  ([shared/fa2_modules/simple_admin.mligo](shared/fa2_modules/simple_admin.mligo)).

## Implemented FA2 Contracts

### [single_asset](single_asset)

[fa2_single_asset.mligo](single_asset/ligo/src/fa2_single_asset.mligo) implementation
of the FA2 contract that supports single fungible tokens (a.k.a ERC-20).

[fa2_single_asset_with_hooks.mligo](single_asset/ligo/src/fa2_single_asset_with_hooks.mligo)
implementation of the FA2 contract that supports single fungible tokens (a.k.a ERC-20)
and sender/receiver hooks.

[fa12_lorentz.tz](single_asset/lorentz/out/fa12_lorentz.tz)
implementation of the FA1.2 contract that supports single fungible tokens
(a.k.a. ERC-20).

### [multi_asset](multi_asset)

[fa2_multi_asset.mligo](multi_asset/ligo/src/fa2_multi_asset.mligo) implementation
of the FA2 contract that supports multiple fungible tokens (a.k.a. ERC-1155).

[fa2_granular_multi_asset.mligo](multi_asset/ligo/src/fa2_granular_multi_asset.mligo)
implementation of the FA2 contract that supports multiple fungible tokens
(a.k.a. ERC-1155) that allows pausing/un-pausing transfers on individual tokens.

### [fa2_hooks](fa2_hooks)

[fa2_multi_asset.mligo](fa2_hooks/ligo/src/fa2_multi_asset.mligo) implementation
of the FA2 contract that supports multiple fungible tokens (a.k.a. ERC-1155) and
sender/receiver hooks.

### [nft_asset](nft_assets)

[fa2_nft_asset.mligo](nft_assets/ligo/src/fa2_nft_asset.mligo) implementation
of the NFT FA2 contract (a.k.a. ERC-721). The contract supports multiple "families"
of NFT tokens that share the same token metadata.

### [collectibles](collectibles)

[fa2_fixed_collection_asset.mligo](collectibles/ligo/src/fa2_fixed_collection_asset.mligo)
implementation of the fixed collection of NFT tokens (a.k.a. ERC-721). The FA2
contract is originated with the predefined set of NFT tokens. Tokens cannot be
minted or burned.

### [fractional](fractional)

[fractional_dao.mligo](fractional/ligo/src/fractional_dao.mligo) implementation
of DAO that manages fractional ownership of NFT tokens. The DAO is the owner of
an NFT token in the corresponding FA2 NFT contract and also manages fractional
ownership fungible token for each owned NFT. Holders of the linked ownership fungible
tokens can vote (directly or using signed permit) on transfer of the NFT token to
some other address.

### [generic_fractional_dao](generic_fractional_dao)

[fractional_dao.mligo](generic_fractional_dao/ligo/src/fractional_dao.mligo)
implementation of a generic fractional DAO user fractional voting to control any
generic operation represented by a lambda function. Such lambda can transfer tokens,
buy/sell tokens on market place or auction or perform any other generic operation.
Fractional ownership is controlled by allocation of the ownership fungible token
managed by the DAO. The DAO itself is a FA2 contracts that supports standard FA2
API to manage the ownership token.

smart-contracts

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

smart-contracts

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README