Sandbox Passes contract

packages/game-passes/.eslintignore

@@ -0,0 +1,16 @@
+node_modules
+.env
+coverage
+coverage.json
+typechain
+typechain-types
+
+# Hardhat files
+cache
+artifacts
+
+# generated docs
+generated-markups
+
+# editors
+.idea

packages/game-passes/.eslintrc.js

@@ -0,0 +1,41 @@
+const path = require('path');
+const tsconfigPath = path.join(__dirname, 'tsconfig.json');
+module.exports = {
+  root: true,
+  extends: [
+    'eslint:recommended',
+    'plugin:mocha/recommended',
+    'plugin:prettier/recommended',
+  ],
+  parserOptions: {
+    ecmaVersion: 2020,
+  },
+  plugins: ['mocha'],
+  env: {
+    commonjs: true,
+    node: true,
+    mocha: true,
+  },
+  overrides: [
+    {
+      files: ['*.ts'],
+      parser: '@typescript-eslint/parser',
+      parserOptions: {
+        project: [tsconfigPath],
+        ecmaVersion: 2020,
+        sourceType: 'module',
+      },
+      plugins: ['mocha', '@typescript-eslint'],
+      extends: [
+        'eslint:recommended',
+        'plugin:@typescript-eslint/recommended',
+        'plugin:mocha/recommended',
+        'plugin:prettier/recommended',
+      ],
+      rules: {
+        '@typescript-eslint/no-misused-promises': 'error',
+        '@typescript-eslint/no-floating-promises': 'error',
+      },
+    },
+  ],
+};

packages/game-passes/.gitignore

@@ -0,0 +1,17 @@
+node_modules
+.env
+coverage
+coverage.json
+typechain
+typechain-types
+
+# Hardhat files
+cache
+artifacts
+./artifacts
+./cache
+./typechain
+
+deployments
+
+storageLayout

packages/game-passes/.prettierignore

@@ -0,0 +1,16 @@
+node_modules
+.env
+coverage
+coverage.json
+typechain
+typechain-types
+
+# Hardhat files
+cache
+artifacts
+
+# generated docs
+generated-markups
+
+# editors
+.idea

packages/game-passes/.prettierrc.cjs

@@ -0,0 +1,21 @@
+module.exports = {
+  singleQuote: true,
+  bracketSpacing: false,
+  plugins: ['prettier-plugin-solidity'],
+  overrides: [
+    {
+      files: '*.md',
+      options: {
+        proseWrap: 'always',
+      },
+    },
+    {
+      files: '*.sol',
+      options: {
+        printWidth: 120,
+        tabWidth: 4,
+        singleQuote: false,
+      },
+    },
+  ],
+};

packages/game-passes/.solcover.js

@@ -0,0 +1,7 @@
+module.exports = {
+  mocha: {
+    grep: '@skip-on-coverage', // Find everything with this tag
+    invert: true, // Run the grep's inverse set.
+  },
+  skipFiles: ['mock'],
+};

packages/game-passes/.solhint.json

@@ -0,0 +1,14 @@
+{
+  "extends": "solhint:recommended",
+  "plugins": ["prettier"],
+  "rules": {
+    "prettier/prettier": [
+      "error",
+      {
+        "endOfLine": "auto"
+      }
+    ],
+    "compiler-version": ["error", "^0.8.0"],
+    "func-visibility": ["error", {"ignoreConstructors": true}]
+  }
+}

packages/game-passes/README.md

@@ -0,0 +1,86 @@
+# SandboxPasses1155 - NFT Pass System
+
+## Overview
+
+SandboxPasses1155 is a smart contract that powers a flexible NFT pass system on
+the Ethereum blockchain. It allows for the creation, management, and
+distribution of digital passes that can be used for various purposes including
+event access, membership benefits, and digital collectibles.
+
+## Key Features
+
+### 📱 Multi-Token Support
+
+- A single contract can manage many different types of passes
+- Each pass type has its own configuration, supply limits, and transferability
+  rules
+
+### 🔒 Flexible Transferability
+
+- Passes can be configured as transferable or non-transferable (soulbound)
+- Admins can whitelist specific addresses to transfer otherwise non-transferable
+  passes
+- Helps maintain integrity for access passes and credentials
+
+### 🏷️ Supply Controls
+
+- Set maximum supply limits for each pass type
+- Configure how many of each pass type a single wallet can hold
+- Prevent overconcentration of passes in single wallets
+
+### 💰 Payment Integration
+
+- Built-in support for payments in ERC20 tokens
+- Configurable treasury addresses to receive payments
+- Different pass types can have different payment recipients
+
+### 🔄 Pass Transformation
+
+- Users can burn existing passes to receive new ones
+- Supports upgrade paths and token evolution
+- Operator-controlled transformations for managed ecosystems
+
+### 🛡️ Security Features
+
+- Role-based access control for administrative functions
+- Pausable functionality for emergency situations
+- Signature-based minting for secure off-chain authorization
+- Meta-transaction support for better user experience
+
+### 💸 Royalty Support
+
+- ERC2981 royalty standard implementation
+- Configure royalties for secondary market sales
+- Set default royalties or override for specific pass types
+
+## User Interactions
+
+### For Pass Holders
+
+- Mint passes using authorized signatures
+- Transform existing passes into new pass types
+- Transfer passes (if allowed by configuration)
+- Use passes for access to services or content
+
+### For Administrators
+
+- Configure new pass types with custom properties
+- Mint passes directly to users
+- Update pass configurations and metadata
+- Manage transferability and access control
+- Pause/unpause contract functions in emergencies
+- Recover accidentally sent tokens
+
+## Technical Details
+
+This contract implements several Ethereum standards:
+
+- ERC1155: Multi-token standard
+- ERC2981: NFT royalty standard
+- ERC2771: Meta-transactions for gas-less operations
+
+The contract is designed to be deployed behind a proxy for upgradeability,
+allowing the functionality to evolve over time while maintaining the same
+contract address and token balances.
+
+---