Allow-Block list token (#399)

Author: tiago18c

tokens/token-2022/transfer-hook/allow-block-list-token/.gitignore

@@ -0,0 +1,44 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+
+# Anchor
+/anchor/target/

tokens/token-2022/transfer-hook/allow-block-list-token/.prettierignore

@@ -0,0 +1,14 @@
+# Add files here to ignore them from prettier formatting
+/anchor/target/debug
+/anchor/target/deploy
+/anchor/target/release
+/anchor/target/sbf-solana-solana
+/anchor/target/test-ledger
+/anchor/target/.rustc_info.json
+/dist
+/coverage
+.next
+/tmp
+package-lock.json
+pnpm-lock.yaml
+yarn.lock

tokens/token-2022/transfer-hook/allow-block-list-token/.prettierrc

@@ -0,0 +1,7 @@
+{
+  "arrowParens": "always",
+  "printWidth": 120,
+  "semi": false,
+  "singleQuote": true,
+  "trailingComma": "all"
+}

tokens/token-2022/transfer-hook/allow-block-list-token/README.md

@@ -0,0 +1,50 @@
+# AllowBlockList Token
+
+An example of a allow / block list token using token extensions.
+
+## Features
+
+Allows the creation of an allow block list with a list authority.
+The allow/block list is then consumed by a transfer-hook.
+
+The list is managed by a single authority and can be used by several token mints. This enables a separation of concerns between token management and allow/block list management, ideal for scenarios where an issuer wants a 3rd party managed allow/block list or wants to share the same list across a group of assets.
+
+Initializes new tokens with several configuration options:
+- Permanent delegate
+- Allow list
+- Block list
+- Metadata
+- Authorities
+
+The issuer can configure the allow and block list with 3 distinct configurations:
+- Force Allow: requires everyone receiving tokens to be explicitly allowed in
+- Block: allows everyone to receive tokens unless explicitly blocked
+- Threshold Allow: allows everyone to receive tokens unless explicitly blocked up until a given transfer amount threshold. Transfers larger than the threshold require explicitly allow
+
+These configurations are saved in the token mint metadata.
+
+This repo includes a UI to manage the allow/block list based on the `legacy-next-tailwind-basic` template. It also allows creating new token mints on the spot with transfer-hook enabled along with token transfers given that most wallets fail to fetch transfer-hook dependencies on devnet and locally.
+
+## Setup
+
+Install dependencies:
+`yarn install`
+
+Compile the program:
+`anchor build`
+
+Compile the UI:
+`yarn run build`
+
+Serve the UI:
+`yarn run dev`
+
+### Local testing
+
+There are a couple scripts to manage the local validator and deployment.
+
+To start the local validator and deploy the program:
+`./scripts/start.sh`
+
+To stop the local validator:
+`./scripts/stop.sh`

tokens/token-2022/transfer-hook/allow-block-list-token/anchor/.gitignore

@@ -0,0 +1,13 @@
+.anchor
+.DS_Store
+target/debug
+target/deploy
+target/release
+target/sbf-solana-solana
+target/test-ledger
+target/.rustc_info.json
+**/*.rs.bk
+node_modules
+test-ledger
+.yarn
+ledger

tokens/token-2022/transfer-hook/allow-block-list-token/anchor/.prettierignore

@@ -0,0 +1,7 @@
+.anchor
+.DS_Store
+target
+node_modules
+dist
+build
+test-ledger

tokens/token-2022/transfer-hook/allow-block-list-token/anchor/Anchor.toml

@@ -0,0 +1,19 @@
+[toolchain]
+package_manager = "yarn"
+
+[features]
+resolution = true
+skip-lint = false
+
+[programs.localnet]
+abl-token = "LtkoMwPSKxAE714EY3V1oAEQ5LciqJcRwQQuQnzEhQQ"
+
+[registry]
+url = "https://api.apr.dev"
+
+[provider]
+cluster = "localnet"
+wallet = "~/.config/solana/id.json"
+
+[scripts]
+test = "../node_modules/.bin/jest --preset ts-jest"

tokens/token-2022/transfer-hook/allow-block-list-token/anchor/Cargo.toml

@@ -0,0 +1,14 @@
+[workspace]
+members = [
+    "programs/*"
+]
+resolver = "2"
+
+[profile.release]
+overflow-checks = true
+lto = "fat"
+codegen-units = 1
+[profile.release.build-override]
+opt-level = 3
+incremental = false
+codegen-units = 1

tokens/token-2022/transfer-hook/allow-block-list-token/anchor/programs/abl-token/Cargo.toml

@@ -0,0 +1,45 @@
+[package]
+name = "abl-token"
+version = "0.1.0"
+description = "Created with Anchor"
+edition = "2021"
+
+[lib]
+crate-type = ["cdylib", "lib"]
+name = "abl_token"
+
+[features]
+default = []
+cpi = ["no-entrypoint"]
+no-entrypoint = []
+no-idl = []
+no-log-ix-name = []
+idl-build = ["anchor-lang/idl-build", "anchor-spl/idl-build"]
+
+
+[dependencies]
+anchor-lang = { version = "0.31.1", features = ["interface-instructions"] }
+anchor-spl = { version = "0.31.1", features = [
+    "token_2022_extensions",
+    "token_2022",
+] }
+
+
+spl-tlv-account-resolution = "0.8.1"
+spl-transfer-hook-interface = { version = "0.8.2" }
+spl-discriminator = "0.3"
+
+[dev-dependencies]
+litesvm = "0.6.1"
+
+
+solana-instruction = "2.2.1"
+solana-keypair = "2.2.1"
+solana-native-token = "2.2.1"
+solana-pubkey = "2.2.1"
+solana-signer = "2.2.1"
+solana-system-interface = "1.0.0"
+solana-transaction = "2.2.1"
+solana-message = "2.2.1"
+solana-sdk-ids = "2.2.1"
+spl-token-2022 = { version = "8.0.1", features = ["no-entrypoint"]}

tokens/token-2022/transfer-hook/allow-block-list-token/anchor/programs/abl-token/Xargo.toml

@@ -0,0 +1,2 @@
+[target.bpfel-unknown-unknown.dependencies.std]
+features = []