Merge pull request #2065 from hirosystems/beta

release v8.0.0 to master

Author: rafaelcr

.eslintignore

@@ -16,3 +16,4 @@ src/tests-bns/
 client/src/
 config/
 utils/src/
+client*

.github/workflows/ci.yml

@@ -52,56 +52,6 @@ jobs:
       - name: Lint Unused Exports
         run: npm run lint:unused-exports
 
-  lint-docs:
-    runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: ./docs
-    steps:
-      - uses: actions/checkout@v3
-        with:
-          fetch-depth: 0
-
-      - name: Use Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version-file: ".nvmrc"
-
-      - name: Cache node modules
-        uses: actions/cache@v3
-        env:
-          cache-name: cache-node-modules
-        with:
-          path: |
-            ~/.npm
-            **/node_modules
-          key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}
-          restore-keys: |
-            ${{ runner.os }}-build-${{ env.cache-name }}-
-            ${{ runner.os }}-build-
-            ${{ runner.os }}-
-
-      - name: Install deps
-        run: npm ci --audit=false
-
-      - name: Build schema & docs
-        run: npm run build
-
-      - name: Validate generated types
-        run: tsc index.d.ts
-
-      - name: Lint JSON
-        run: npm run lint:json
-
-      - name: Lint YAML
-        run: npm run lint:yaml
-
-      - name: Lint OpenAPI
-        run: npm run lint:openapi
-
-      - name: Validate schemas
-        run: npm run validate:schemas
-
   test:
     runs-on: ubuntu-latest
     steps:
@@ -133,10 +83,6 @@ jobs:
         working-directory: client
         run: npm ci --audit=false
 
-      - name: Install docs deps
-        working-directory: docs
-        run: npm ci --audit=false
-
       - name: Setup env vars
         run: echo "STACKS_CORE_EVENT_HOST=http://0.0.0.0" >> $GITHUB_ENV
 
@@ -415,68 +361,6 @@ jobs:
           flag-name: run-${{ github.job }}
           parallel: true
 
-  test-subnets:
-    if: false
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-
-      - name: Use Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version-file: '.nvmrc'
-
-      - name: Cache node modules
-        uses: actions/cache@v3
-        env:
-          cache-name: cache-node-modules
-        with:
-          path: |
-            ~/.npm
-            **/node_modules
-          key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}
-          restore-keys: |
-            ${{ runner.os }}-build-${{ env.cache-name }}-
-            ${{ runner.os }}-build-
-            ${{ runner.os }}-
-
-      - name: Install deps
-        run: npm ci --audit=false
-
-      - name: Setup env vars
-        run: echo "STACKS_CORE_EVENT_HOST=http://0.0.0.0" >> $GITHUB_ENV
-
-      - name: Setup integration environment
-        run: |
-          sudo ufw disable
-          npm run devenv:deploy:subnets -- -d
-          npm run devenv:logs:subnets -- --no-color &> docker-compose-logs.txt &
-
-      - name: Run tests
-        run: npm run test:subnets
-
-      - name: Print integration environment logs
-        run: cat docker-compose-logs.txt
-        if: failure()
-
-      - name: Teardown integration environment
-        run: npm run devenv:stop:subnets
-        if: always()
-
-      - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v4
-        with:
-          token: ${{ secrets.CODECOV_TOKEN }}
-        if: always()
-
-      - name: Upload coverage to Coveralls
-        uses: coverallsapp/github-action@master
-        if: always()
-        with:
-          github-token: ${{ secrets.github_token }}
-          flag-name: run-${{ github.job }}
-          parallel: true
-
   test-bns-e2e:
     runs-on: ubuntu-latest
     steps:

.gitignore

@@ -129,3 +129,7 @@ yarn.lock
 #rosetta-cli results
 rosetta-output-construction/rosetta-cli-output-const.json
 rosetta-output/rosetta-cli-output.json
+
+# doc schema
+docs/openapi.json
+docs/openapi.yaml

.prettierignore

@@ -4,3 +4,4 @@ src/tests-rosetta/
 src/tests-rosetta-cli/
 src/tests-bns/
 src/tests/synthetic-tx-payloads/
+src/rosetta/json-schemas/

.proxy-cache-control.json

@@ -28,14 +28,14 @@
     [
       "@semantic-release/exec",
       {
-        "execCwd": "client",
         "prepareCmd": "npm ci"
       }
     ],
     [
-      "@semantic-release/npm",
+      "@semantic-release/exec",
       {
-        "pkgRoot": "./docs"
+        "execCwd": "client",
+        "prepareCmd": "npm ci"
       }
     ],
     [

.releaserc

@@ -22,7 +22,6 @@
       "args": ["${workspaceFolder}/src/index.ts"],
       "outputCapture": "std",
       "internalConsoleOptions": "openOnSessionStart",
-      "preLaunchTask": "generate:schemas",
       "env": {
         "NODE_ENV": "development",
         "TS_NODE_SKIP_IGNORE": "true"

.vscode/launch.json

@@ -3,14 +3,6 @@
   // for the documentation about the tasks.json format
   "version": "2.0.0",
   "tasks": [
-    {
-      "label": "generate:schemas",
-      "type": "npm",
-      "script": "generate:schemas",
-      "presentation": {
-        "reveal": "silent"
-      }
-    },
     {
       "label": "stacks-node:deploy-dev",
       "type": "shell",

.vscode/tasks.json

@@ -1,8 +1,61 @@
-## [7.14.1](https://github.com/hirosystems/stacks-blockchain-api/compare/v7.14.0...v7.14.1) (2024-08-21)
+## [8.0.0-beta.6](https://github.com/hirosystems/stacks-blockchain-api/compare/v8.0.0-beta.5...v8.0.0-beta.6) (2024-08-27)
+
+
+### ⚠ BREAKING CHANGES
+
+* refactor from express to fastify (#2045)
+
+### Features
+
+* cursor-based pagination on blocks endpoint ([#2060](https://github.com/hirosystems/stacks-blockchain-api/issues/2060)) ([bfdcce1](https://github.com/hirosystems/stacks-blockchain-api/commit/bfdcce1c2936980299c90bf36f3d45fe74bd573c))
+* export events tsv directly to postgres instance ([#2048](https://github.com/hirosystems/stacks-blockchain-api/issues/2048)) ([f401a0f](https://github.com/hirosystems/stacks-blockchain-api/commit/f401a0f676ced14572b9f3f263dcc8559e831cdf))
+* export events tsv directly to postgres instance ([#2048](https://github.com/hirosystems/stacks-blockchain-api/issues/2048)) ([#2058](https://github.com/hirosystems/stacks-blockchain-api/issues/2058)) ([a1f5b12](https://github.com/hirosystems/stacks-blockchain-api/commit/a1f5b12675118f6d7742c54e3420c38151aef4a7))
+* refactor from express to fastify ([#2045](https://github.com/hirosystems/stacks-blockchain-api/issues/2045)) ([bd65fcf](https://github.com/hirosystems/stacks-blockchain-api/commit/bd65fcf93984c37a9de3cb284c43a49cb6b3694a)), closes [#2042](https://github.com/hirosystems/stacks-blockchain-api/issues/2042)
+
+
+### Bug Fixes
+
+* index on `principal_stx_txs` table for faster `/v1/address/{addr}/transactions` lookups ([#2059](https://github.com/hirosystems/stacks-blockchain-api/issues/2059)) ([ab64ab7](https://github.com/hirosystems/stacks-blockchain-api/commit/ab64ab7148a3656f81f0a3c5a176c40caca3345a))
+
+## [8.0.0-beta.5](https://github.com/hirosystems/stacks-blockchain-api/compare/v8.0.0-beta.4...v8.0.0-beta.5) (2024-08-16)
+
+
+### Bug Fixes
+
+* perform status endpoint sql inside transactions ([b23445c](https://github.com/hirosystems/stacks-blockchain-api/commit/b23445c85f826d0e6cf98695f985c3670d00c1db))
+
+## [8.0.0-beta.4](https://github.com/hirosystems/stacks-blockchain-api/compare/v8.0.0-beta.3...v8.0.0-beta.4) (2024-08-15)
 
 
 ### Bug Fixes
 
+* missing event limit max overrides on a few endpoints ([4f70930](https://github.com/hirosystems/stacks-blockchain-api/commit/4f709308fb95721866b523142536b738aa64a3eb))
+
+## [8.0.0-beta.3](https://github.com/hirosystems/stacks-blockchain-api/compare/v8.0.0-beta.2...v8.0.0-beta.3) (2024-08-15)
+
+
+### Bug Fixes
+
+* tx event-limit default should be 100 ([32d0670](https://github.com/hirosystems/stacks-blockchain-api/commit/32d0670a531582b8eb269790fa7a3695a8ce7610))
+
+## [8.0.0-beta.2](https://github.com/hirosystems/stacks-blockchain-api/compare/v8.0.0-beta.1...v8.0.0-beta.2) (2024-08-15)
+
+
+### Bug Fixes
+
+* pagination and query param parsing bugs ([a382d2b](https://github.com/hirosystems/stacks-blockchain-api/commit/a382d2b80fc8d3e7ff49ce96047f1621749172b2)), closes [#2042](https://github.com/hirosystems/stacks-blockchain-api/issues/2042)
+
+## [8.0.0-beta.1](https://github.com/hirosystems/stacks-blockchain-api/compare/v7.13.2...v8.0.0-beta.1) (2024-08-13)
+
+
+### ⚠ BREAKING CHANGES
+
+* refactor from Express to Fastify
+
+### Features
+
+* refactor from Express to Fastify ([aa0e51e](https://github.com/hirosystems/stacks-blockchain-api/commit/aa0e51e557491daff1a98dd36c4e952e05c58dd4)), closes [#2042](https://github.com/hirosystems/stacks-blockchain-api/issues/2042)
+
 * index on `principal_stx_txs` table for faster `/v1/address/{addr}/transactions` lookups ([#2059](https://github.com/hirosystems/stacks-blockchain-api/issues/2059)) ([ab64ab7](https://github.com/hirosystems/stacks-blockchain-api/commit/ab64ab7148a3656f81f0a3c5a176c40caca3345a))
 
 ## [7.14.0](https://github.com/hirosystems/stacks-blockchain-api/compare/v7.13.2...v7.14.0) (2024-08-20)

CHANGELOG.md

@@ -0,0 +1,73 @@
+## @stacks/blockchain-api-client (<=7.x.x) → (8.x.x)
+
+## Breaking Changes
+
+This library is now generated with [openapi-typescript](https://openapi-ts.dev/openapi-fetch/) rather than [swagger-codegen](https://github.com/swagger-api/swagger-codegen). Several types which previously presented as the `any` type are now fixed, and the `@stacks/stacks-blockchain-api-types` package is no longer needed.
+
+
+This repo no longer includes a schema for the Stacks Blockchain RPC interface. An alternative client library for the RPC interface can be found at https://github.com/hirosystems/stacks.js/pull/1737.
+
+#### Configuration & Middleware
+
+```ts
+// old:
+import { TransactionsApi, Configuration } from '@stacks/blockchain-api-client';
+const client = new TransactionsApi(new Configuration({
+  basePath: 'https://api.mainnet.hiro.so',
+  middleware: [{
+    pre({url, init}) {
+      init.headers = new Headers(init.headers);
+      init.headers.set('x-custom-header', 'custom-value');
+      return Promise.resolve({ url, init });
+    }
+  }]
+}));
+
+
+// new:
+import { createClient } from '@stacks/blockchain-api-client';
+const client = createClient({
+  baseUrl: 'https://api.mainnet.hiro.so'
+});
+client.use({
+  onRequest({request}) {
+    request.headers.set('x-custom-header', 'custom-value');
+    return request;
+  }
+});
+```
+
+#### Performing Requests
+
+```ts
+// old:
+const blockTxs = await client.getTransactionsByBlock({
+  heightOrHash: 2000,
+  limit: 20,
+  offset: 100
+});
+console.log('Block transactions:', blockTxs);
+
+// new:
+const { data: blockTxs } = await client.GET('/extended/v2/blocks/{height_or_hash}/transactions', { 
+  params: { 
+    path: { height_or_hash: 2000 }, 
+    query: { limit: 20, offset: 100 },
+  }
+});
+console.log('Block transactions:', blockTxs);
+```
+
+#### Referencing Types
+
+```ts
+// old:
+import { MempoolTransactionStatsResponse } from '@stacks/blockchain-api-client';
+let response: MempoolTransactionStatsResponse;
+response = await client.getMempoolTransactionStats();
+
+// new:
+import { OperationResponse } from '@stacks/blockchain-api-client';
+let response: OperationResponse['/extended/v1/tx/mempool/stats'];
+response = (await client.GET('/extended/v1/tx/mempool/stats')).data;
+```

client/.eslintrc.js

@@ -3,6 +3,10 @@
 
 A JS Client for the Stacks Blockchain API
 
+## Breaking changes from (<=7.x.x) → (8.x.x)
+
+See [MIGRATION.md](./MIGRATION.md) for details.
+
 ## Features
 
 This package provides the ability to: