create-near-app 8.3.0 → 8.4.1

package/dist/messages.js

@@ -24,9 +24,21 @@ Please refer to https://github.com/near/create-near-app README to troubleshoot.
 Notice: some platforms aren't supported (yet).
 {bold {red ==========================================}}`);
 exports.setupFailed = setupFailed;
+const mapContractLanguage = (contract) => {
+    switch (contract) {
+        case 'ts':
+            return 'Typescript';
+        case 'rs':
+            return 'Rust';
+        case 'py':
+            return 'Python';
+        default:
+            return '';
+    }
+};
 const successContractToText = (contract) => contract === 'none'
     ? ''
-    : (0, chalk_1.default) `a smart contract in {bold ${contract === 'rs' ? 'Rust' : 'Typescript'}}`;
+    : (0, chalk_1.default) `a smart contract in {bold ${mapContractLanguage(contract)}}`;
 exports.successContractToText = successContractToText;
 const frontendTemplates = {
     'next-page': 'NextJS (Classic)',
@@ -38,7 +50,7 @@ const successFrontendToText = (frontend) => frontend === 'none'
     : (0, chalk_1.default) `a web-app using ${frontendTemplates[frontend]}`;
 exports.successFrontendToText = successFrontendToText;
 const setupSuccess = (projectName, contract, frontend, install, needsToInstallCargoNear) => (0, exports.show)((0, chalk_1.default) `
-✅  Success! Created '${projectName}', ${(0, exports.successContractToText)(contract)}${(0, exports.successFrontendToText)(frontend)}.
+✅ Success! Created '${projectName}', ${(0, exports.successContractToText)(contract)}${(0, exports.successFrontendToText)(frontend)}.
 ${contract === 'rs'
     ? (0, chalk_1.default) `🦀 If you are new to Rust please visit {bold {green https://www.rust-lang.org }}\n`
     : ''}
@@ -64,6 +76,9 @@ const contractInstructions = (projectName, contract, install, needsToInstallCarg
     if (contract === 'ts') {
         message += (0, chalk_1.default) `         {blue npm {bold run build}}\n`;
     }
+    else if (contract === 'py') {
+        message += (0, chalk_1.default) `         {blue {bold uvx nearc contract.py --create-venv}}\n`;
+    }
     else {
         message += (0, chalk_1.default) `         {blue {bold cargo near build}}\n`;
     }
@@ -71,6 +86,9 @@ const contractInstructions = (projectName, contract, install, needsToInstallCarg
     if (contract === 'ts') {
         message += (0, chalk_1.default) `         {blue npm {bold run test}}\n`;
     }
+    else if (contract === 'py') {
+        message += (0, chalk_1.default) `         {blue {bold uv run pytest}}\n`;
+    }
     else {
         message += (0, chalk_1.default) `         {blue {bold cargo near test}}\n`;
     }

package/dist/types.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.APPS = exports.FRONTENDS = exports.CONTRACTS = void 0;
-exports.CONTRACTS = ['ts', 'rs', 'none'];
+exports.CONTRACTS = ['ts', 'rs', 'py', 'none'];
 exports.FRONTENDS = ['next-app', 'next-page', 'vite-react', 'none'];
 exports.APPS = ['contract', 'gateway'];
 //# sourceMappingURL=types.js.map

package/dist/user-input.js

@@ -57,6 +57,7 @@ const appChoices = [
 const contractChoices = [
     { title: 'JS/TS Contract', description: 'A Near contract written in javascript/typescript', value: 'ts' },
     { title: 'Rust Contract', description: 'A Near contract written in Rust', value: 'rs' },
+    { title: 'Python Contract', description: 'A Near contract written in Python', value: 'py' },
 ];
 const frontendChoices = [
     { title: 'NextJs (Classic)', description: 'A web-app built using Next.js Page Router', value: 'next-page' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-near-app",
-  "version": "8.3.0",
+  "version": "8.4.1",
   "description": "Quickly scaffold your dApp on NEAR Blockchain",
   "main": "index.js",
   "engines": {

package/templates/contracts/py/.python-version

@@ -0,0 +1 @@
+3.13

package/templates/contracts/py/README.md

@@ -0,0 +1,74 @@
+# contract-py
+
+cargo-near-new-project-description
+
+## How to Build Locally?
+
+Install Python and Emscripten:
+
+```bash
+# Install Python (if not already installed)
+# Use your system's package manager or download from https://www.python.org/downloads/
+
+# Install Emscripten (required for compiling Python contracts to WebAssembly)
+# For Linux/macOS:
+git clone https://github.com/emscripten-core/emsdk.git
+cd emsdk
+./emsdk install latest
+./emsdk activate latest
+source ./emsdk_env.sh
+# Add to your .bashrc or .zshrc for permanent installation:
+# echo 'source "/path/to/emsdk/emsdk_env.sh"' >> ~/.bashrc
+cd ..
+
+# For Windows:
+# Download and extract: https://github.com/emscripten-core/emsdk
+# Then in Command Prompt:
+# cd emsdk
+# emsdk install latest
+# emsdk activate latest
+# emsdk_env.bat
+
+# Verify installation with:
+emcc --version
+
+# Install uv for Python package management
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Install NEAR CLI-RS to deploy and interact with the contract
+curl --proto '=https' --tlsv1.2 -LsSf https://github.com/near/near-cli-rs/releases/latest/download/near-cli-rs-installer.sh | sh
+```
+
+Then run:
+
+```bash
+uvx nearc greeting_contract.py
+```
+
+## How to Test Locally?
+
+```bash
+uv run pytest
+```
+
+## How to Deploy?
+
+To deploy manually, install [`cargo-near`](https://github.com/near/cargo-near) and run:
+
+```bash
+# Create a new account
+cargo near create-dev-account
+
+# Deploy the contract on it
+cargo near deploy <account-id>
+```
+## Useful Links
+
+- [cargo-near](https://github.com/near/cargo-near) - NEAR smart contract development toolkit for Rust
+- [near CLI](https://near.cli.rs) - Iteract with NEAR blockchain from command line
+- [NEAR Python SDK Documentation](https://github.com/r-near/near-sdk-py)
+- [NEAR Documentation](https://docs.near.org)
+- [NEAR StackOverflow](https://stackoverflow.com/questions/tagged/nearprotocol)
+- [NEAR Discord](https://near.chat)
+- [NEAR Telegram Developers Community Group](https://t.me/neardev)
+- NEAR DevHub: [Telegram](https://t.me/neardevhub), [Twitter](https://twitter.com/neardevhub)

package/templates/contracts/py/contract.py

@@ -0,0 +1,31 @@
+from near_sdk_py import Contract, view, call, init
+
+class GreetingContract(Contract):
+    """
+    A simple greeting contract that stores and returns a message.
+    """
+    
+    @init
+    def initialize(self, default_message="Hello, NEAR world!"):
+        """
+        Initialize the contract with a default greeting message.
+        """
+        self.storage["greeting"] = default_message
+        return {"success": True}
+    
+    @call
+    def set_greeting(self, message: str):
+        """
+        Change the greeting message.
+        """
+        self.storage["greeting"] = message
+        self.log_info(f"Saving greeting: {message}")
+        return {"success": True}
+    
+    @view
+    def get_greeting(self):
+        """
+        Retrieve the current greeting message.
+        """
+        return self.storage.get("greeting", "Hello, NEAR world!")
+        

package/templates/contracts/py/pyproject.toml

@@ -0,0 +1,10 @@
+[project]
+name = "py-near"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "near-pytest>=0.7.1",
+    "near-sdk-py>=0.7.3",
+]

package/templates/contracts/py/tests/test_mod.py

@@ -0,0 +1,53 @@
+from near_pytest.testing import NearTestCase
+import json
+
+class TestGreetingContract(NearTestCase):
+    @classmethod
+    def setup_class(cls):
+        """Compile and deploy the greeting contract."""
+        super().setup_class()
+        
+        # Compile the contract
+        wasm_path = cls.compile_contract(
+            "contract.py",
+            single_file=True
+        )
+        
+        # Deploy the contract
+        cls.contract_account = cls.create_account("contract")
+        cls.instance = cls.deploy_contract(cls.contract_account, wasm_path)
+        
+        # Initialize the contract
+        cls.instance.call_as(
+            account=cls.contract_account,
+            method_name="initialize",
+            args={"default_message": "Initial greeting"},
+        )
+        
+        # Create test user
+        cls.user = cls.create_account("user")
+        
+        # Save state for future resets
+        cls.save_state()
+    
+    def setup_method(self):
+        """Reset state before each test method."""
+        self.reset_state()
+        
+    def test_greeting(self):
+        # Set greeting as user
+        result = self.instance.call_as(
+            account=self.user,
+            method_name="set_greeting",
+            args={"message": "Hello from test!"}
+        )
+        result = json.loads(result.text)
+        assert result["success"] == True
+        
+        # Get greeting
+        greeting = self.instance.call_as(
+            account=self.user,
+            method_name="get_greeting"
+        )
+        assert greeting.text == "Hello from test!"
+