feat: update default btl to 100 for create and update entity

Author: Matthias Zimmermann

PUBLISHING.md

@@ -102,7 +102,7 @@ export TESTPYPI_TOKEN="pypi-..."
 
 ## Publishing Workflow
 
-### Using scripts/publish.sh (Interactive)
+### Publish to TestPyPi
 
 1. Ensure you're on the correct branch with latest changes
 
@@ -127,8 +127,7 @@ Run full quality check (iterate until all green)
 ./scripts/check-all.sh
 ```
 
-
-4. Commit version changes
+5. Commit version changes
 
 ```bash
 git status # check that this matches with your expectation
@@ -137,8 +136,7 @@ git commit -m "chore: prepare for <latest-version>  release"
 git push
 ```
 
-
-5. Run the publishing wizard
+6. Run the publishing wizard
 ```bash
 ./scripts/publish.sh
 ```
@@ -155,31 +153,62 @@ The script will:
     2) Publish to PyPI (production)
     3) Exit
 
-6. First time: Choose option 1 (TestPyPI)
+7. First time: Choose option 1 (TestPyPI)
 Enter your TESTPYPI_TOKEN when prompted (if not in environment)
 
-7. Test installation from TestPyPI
-Open a terminal outside the IDE
+8. Test installation from TestPyPI
+Open a terminal outside the IDE.
+When the package arkiv-sdk is installed already remove it first.
 
 ```bash
-pip install --index-url https://test.pypi.org/simple/ \
-            --extra-index-url https://pypi.org/simple \
-            arkiv-sdk
+uv pip uninstall arkiv-sdk testcontainers
 ```
 
-8. Verify it works
+Install the dependencies for local development.
+
 ```bash
-python -c "from arkiv import Arkiv, __version__; print(f'Version: {__version__}')"
+uv pip install testcontainers
+uv pip install -i https://test.pypi.org/simple/ arkiv-sdk
+uv run python -c "from arkiv import Arkiv, __version__; print(f'Version: {__version__}')"
 ```
 
-# 9. If all good, run publish script again for production
+9. Do some optional smoke tests using the library
+
+Check the package interactively.
+
+```bash
+uv run python
+```
+
+Python session in interactive shell.
+
+```python
+from arkiv import Arkiv
+client = Arkiv()
+entity_key, _ = client.arkiv.create_entity(payload=b'Hello world!', btl=1000)
+client.arkiv.get_entity(entity_key)
+```
+
+In case of errors/issues analyize and fix them, then repeat publish to TestPyPi.
+Once all checks pass, publish to PyPi (production).
+
+### Publish to PyPi (Production)
+
+1. If all good on TestPyPi, run publish script again for production
+
+```bash
 ./scripts/publish.sh
-# Choose option 2 (PyPI)
-# Enter your PYPI_TOKEN when prompted (if not in environment)
+````
 
-# 10. Create Git tag
+Choose option 2 (PyPI)
+
+
+2. Create Git tag
+
+```bash
 git tag -a v1.0.0a2 -m "Release version 1.0.0a2"
 git push origin v1.0.0a2
+```
 
 # 11. Create GitHub release
 gh release create v1.0.0a2 \

src/arkiv/module.py

@@ -50,6 +50,10 @@
 class ArkivModule:
     """Basic Arkiv module for entity management operations."""
 
+    BTL_DEFAULT = (
+        1000  # Default blocks to live for created entities (~30 mins with 2s blocks)
+    )
+
     def __init__(self, client: "Arkiv") -> None:
         """Initialize Arkiv module with client reference."""
         self.client = client
@@ -106,7 +110,7 @@ def create_entity(
         self,
         payload: bytes | None = None,
         annotations: Annotations | None = None,
-        btl: int = 0,
+        btl: int = BTL_DEFAULT,
         tx_params: TxParams | None = None,
     ) -> tuple[EntityKey, TxHash]:
         """
@@ -115,7 +119,7 @@ def create_entity(
         Args:
             payload: Optional data payload for the entity
             annotations: Optional key-value annotations
-            btl: Blocks to live (default: 0)
+            btl: Blocks to live (default: 1000, ~30 minutes with 2s blocks)
             tx_params: Optional additional transaction parameters
 
         Returns:
@@ -150,7 +154,7 @@ def update_entity(
         entity_key: EntityKey,
         payload: bytes | None = None,
         annotations: Annotations | None = None,
-        btl: int = 0,
+        btl: int = BTL_DEFAULT,
         tx_params: TxParams | None = None,
     ) -> TxHash:
         """
@@ -160,7 +164,7 @@ def update_entity(
             entity_key: The entity key of the entity to update
             payload: Optional new data payload for the entity, existing payload will be replaced
             annotations: Optional new key-value annotations, existing annotations will be replaced
-            btl: Blocks to live (default: 0)
+            btl: Blocks to live (default: 1000, ~30 minutes with 2s blocks)
             tx_params: Optional additional transaction parameters
 
         Returns: