diff --git a/README.md b/README.md
index 9f3a5247..77d24bcf 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,6 @@
-# @iov/cosmos
+# CosmWasm JS
 
-[![npm version](https://img.shields.io/npm/v/cosm-js.svg)](https://www.npmjs.com/package/cosm-js)
-
-This is a Typescript client-side binding to [wasmd](https://github.com/cosmwasm/wasmd), a sample blockchain for the [cosmwasm](https://github.com/confio/cosmwasm) smart contracting platform. 
+This is a JavaScript/TypeScript client-side binding to [wasmd](https://github.com/cosmwasm/wasmd), a sample blockchain for the [cosmwasm](https://github.com/confio/cosmwasm) smart contracting platform.
 
 ## Development
 
diff --git a/package.json b/package.json
index b5a56f15..019ab0a4 100644
--- a/package.json
+++ b/package.json
@@ -1,5 +1,5 @@
 {
-  "name": "cosm-js-monorepo-root",
+  "name": "cosmwasm-js-monorepo-root",
   "description": "Transaction codec and client to communicate with any wasmd blockchain",
   "private": true,
   "author": "Ethan Frey <ethanfrey@users.noreply.github.com>",
@@ -15,7 +15,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/confio/cosm-js"
+    "url": "https://github.com/confio/cosmwasm-js"
   },
   "publishConfig": {
     "access": "public"
diff --git a/packages/bcp/README.md b/packages/bcp/README.md
new file mode 100644
index 00000000..2c9419c6
--- /dev/null
+++ b/packages/bcp/README.md
@@ -0,0 +1,5 @@
+# @cosmwasm/bcp
+
+[![npm version](https://img.shields.io/npm/v/@cosmwasm/bcp.svg)](https://www.npmjs.com/package/@cosmwasm/bcp)
+
+A [BCP](https://github.com/iov-one/iov-core/tree/master/packages/iov-bcp) implementation for CosmWasm.
diff --git a/packages/bcp/package.json b/packages/bcp/package.json
index e2ad28e4..730f2586 100644
--- a/packages/bcp/package.json
+++ b/packages/bcp/package.json
@@ -15,7 +15,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/confio/cosm-js/tree/master/packages/bcp"
+    "url": "https://github.com/confio/cosmwasm-js/tree/master/packages/bcp"
   },
   "publishConfig": {
     "access": "public"
diff --git a/packages/faucet/README.md b/packages/faucet/README.md
index 9cf560a3..dbac1235 100644
--- a/packages/faucet/README.md
+++ b/packages/faucet/README.md
@@ -1,4 +1,6 @@
-# @cosmwasm/faucet
+# @cosmwasm/sdk
+
+[![npm version](https://img.shields.io/npm/v/@cosmwasm/faucet.svg)](https://www.npmjs.com/package/@cosmwasm/faucet)
 
 The faucet is built as part of the monorepo. In the repo root do:
 
diff --git a/packages/faucet/package.json b/packages/faucet/package.json
index 94192f91..cc90b278 100644
--- a/packages/faucet/package.json
+++ b/packages/faucet/package.json
@@ -15,7 +15,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/confio/cosm-js/tree/master/packages/faucet"
+    "url": "https://github.com/confio/cosmwasm-js/tree/master/packages/faucet"
   },
   "publishConfig": {
     "access": "public"
diff --git a/packages/sdk/README.md b/packages/sdk/README.md
new file mode 100644
index 00000000..e6ea142e
--- /dev/null
+++ b/packages/sdk/README.md
@@ -0,0 +1,5 @@
+# @cosmwasm/sdk
+
+[![npm version](https://img.shields.io/npm/v/@cosmwasm/sdk.svg)](https://www.npmjs.com/package/@cosmwasm/sdk)
+
+An SDK to build CosmWasm clients.
diff --git a/packages/sdk/package.json b/packages/sdk/package.json
index a64fd6f0..58d23f45 100644
--- a/packages/sdk/package.json
+++ b/packages/sdk/package.json
@@ -15,7 +15,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/confio/cosm-js/tree/master/packages/sdk"
+    "url": "https://github.com/confio/cosmwasm-js/tree/master/packages/sdk"
   },
   "publishConfig": {
     "access": "public"
diff --git a/packages/sdk/src/types.ts b/packages/sdk/src/types.ts
index 9cf9cdfb..56da7b1a 100644
--- a/packages/sdk/src/types.ts
+++ b/packages/sdk/src/types.ts
@@ -130,7 +130,7 @@ export interface StdSignature {
 export interface PubKey {
   // type is one of the strings defined in pubkeyTypes
   // I don't use a string literal union here as that makes trouble with json test data:
-  // https://github.com/confio/cosm-js/pull/44#pullrequestreview-353280504
+  // https://github.com/confio/cosmwasm-js/pull/44#pullrequestreview-353280504
   readonly type: string;
   // Value field is base64-encoded in all cases
   // Note: if type is Secp256k1, this must contain a COMPRESSED pubkey - to encode from bcp/keycontrol land, you must compress it first